home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_GAME / BAJOR201.ZIP / MANUAL < prev    next >
Text File  |  1994-01-21  |  23KB  |  491 lines
  1.                                 BAJORAN TRIVIA
  2.  
  3.                                 SYSOP's MANUAL
  4.  
  5.                                      v2.1
  6.  
  7.                                January 21, 1994
  8.                            PCBoard 14.x and GAP 4.x
  9.                               WILDCAT!, SPITFIRE
  10.                                 QBBS, RBBS, RA
  11.  
  12.                                       by
  13.  
  14.                               Robert J. Ferguson
  15.                             Klingon SoftWare Labs
  16.                            3421 N. Palethorp Street
  17.                          Philadelphia, PA 19140-4625
  18.  
  19.                        (215) 426-6730 -> Voice Support
  20.                             [Mon-Sat/10am-7pm/Est]
  21.                              FidoNet - 1:273/935
  22.                              KlinNet - 126:6000/0
  23.                    robert.ferguson@f935.n273.z1.fidonet.org
  24.                     (215) 426-5596 -> USRobotics 14.4/HST
  25.  
  26.                               -=-=-=-=-=-=-=-=-
  27.  
  28.                     ┌────────────────────────────────────┐
  29.                     │-=- MAJOR CREDIT CARDS ACCEPTED! -=-│
  30.                    █│Visa - MasterCard - American Express│
  31.                    █│           >>>Door# 6<<<            │
  32.                    █└────────────────────────────────────┘
  33.                    ████████████████████████████████████
  34.                               -=-=-=-=-=-=-=-=-
  35.  
  36.  
  37.                                   ╔════════╗
  38.                                  █║OVERVIEW║
  39.                                  █╚════════╝
  40.                                  █████████
  41.  
  42.   CONGRATULATIONS! You and your users will find this Trivia door entertaining
  43. and educational. It consists of approximately 200+ questions that were
  44. carefully selected for your entertainment. The door displays a "Trivia
  45. Royalty" bulletin to the caller while it creates bulletins and logs for your
  46. use. This door is not CrippleWare, It isn't full of advertisements and
  47. limitations...BEST OF ALL!, I don't charge an arm and a leg. You'll also find
  48. we are responsive to your questions. If you need help or have a suggestion
  49. for improving this product, let me know!
  50.  
  51.   Please be advised that many of the trivia questions were designed to be
  52. complicated ones. Our Klingon Technology Department spent many hours in
  53. research and data collecting for the questions and correct answers. If you
  54. are a true or dedicated "Trekker/Trekkie", you should have no problems
  55. with atleast 60% of the trivia questions. The next Bajoran Trivia Door is
  56. right around the corner guys and gals! Here is a brief list of the changes
  57. since the last public release (1.00.0):
  58.  
  59.  
  60.                                    ╔═════╗
  61.                                   █║LOCAL║
  62.                                   █╚═════╝
  63.                                   ███████
  64.  
  65.   We added a dropfile (CALLINFO.BBS) along with the other files, so you may
  66. run this trivia game in local mode (DOS prompt) to be sure that everything is
  67. running smoothly prior to installing it onto your BBS. Don't forget to rename
  68. your SAMPLE.CFG to BAJOR.CFG, configure it to your liking and at the DOS
  69. prompt type; BAJOR BAJOR.CFG (be sure that the CALLINFO.BBS is in the same
  70. directory as the game).
  71.  
  72.  
  73.                              ╔══════════════════╗
  74.                             █║WHAT IS SHAREWARE?║
  75.                             █╚══════════════════╝
  76.                             ███████████████████
  77.  
  78.   ShareWare is a method of marketing software. ShareWare is not a specific
  79. type of software, nor is it a measure of a program's quality or usefulness.
  80. The shareware concept allows you, the end user, to evaluate software prior to
  81. purchasing. In essence, you get to "TRY BEFORE YOU BUY." After evaluating,
  82. if you find a shareware program useful then you must pay for and register the
  83. program in accordance with the terms in the program's documentation. If you
  84. don't find a shareware program useful, you owe nothing. No hassles.....Enjoy!
  85.  
  86.  
  87.  ╔═════════════════════════════════════════════════════════════════════════╗
  88.  ║                     ■ What's New in Release 2.01? ■                     ║
  89.  ╚═════════════════════════════════════════════════════════════════════════╝
  90.  
  91.  
  92.        Bajoran Trivia Door - Release Notes: o= New  *= Change  != Fix!
  93.  
  94.         o Orders for Bajoran Trivia Door can be made via MasterCard, Visa,
  95.           and American Express!
  96.  
  97.         o Tremendous overhaul and code cleanup in this release.
  98.  
  99.         o The first version of the Bajoran Trivia Door User System could
  100.           only read SFDOORS.DAT Bajoran Trivia now has the ability to
  101.           support the following User Files: CALLINFO.BBS, USERINFO.DAT,
  102.           USERS, PCBOARD.SYS, DOOR.SYS, DORINFOx.DAT, TRIBBS.SYS,
  103.           SFDOORS.DAT
  104.  
  105.         o The first version of the full screen chat module is now in place!
  106.  
  107.         o RIP graphics support!  Supports RIPSCRIP Interface and creates
  108.           ANSI/WC3!.x/PCB/RIP bulletins.
  109.  
  110.         o Bajoran Trivia has a compiler that will allow you to Edit/Add
  111.           questions to your BTREK.DAT file (Registered Version ONLY!).
  112.  
  113.         o ANSI/RIP toggle mode are now both configurable items.
  114.  
  115.         o The Bajoran Trivia SysOp manual (MANUAL) is now printer ready.
  116.  
  117.         o Add/Subtract player's time while online.
  118.  
  119.         o Enable/Disabled Page SysOp functions.
  120.  
  121.         o Shell to DOS while player is online (Drop to DOS).
  122.  
  123.         o Enable/Disable the Alarm.
  124.  
  125.         o Dump a rude player.
  126.  
  127.         o Print player's results while online.
  128.  
  129.         o SysOp can control the player's Questionaire Timer.
  130.  
  131.  
  132.                            ╔══════════════════════╗
  133.                           █║FILES AND DESCRIPTIONS║
  134.                           █╚══════════════════════╝
  135.                           ██████████████████████
  136.  
  137.                   The archive includes the following files:
  138.  
  139.      CALLINFO.BBS  -- Sample dropfile
  140.      DESC.SDI      -- Program description
  141.      FILE_ID.DIZ   -- Program description (for BBS)
  142.      INSTALL.BAT   -- Installation program
  143.      UPGRADE.TXT   -- How to upgrade to next version
  144.      ERROR.QB      -- QuickBasic Error Codes
  145.      BAJOR.EXE     -- The main executable file
  146.      SAMPLE.CFG    -- The sample configuration file
  147.      BTREK.DAT     -- The main trivia data file
  148.      SAMPLE.LOG    -- A sample of the log file produced
  149.      SCREENS.ZIP   -- Screens for the BAJORAN\SCREENS sub directory
  150.      MANUAL        -- The installation instructions...(this file)
  151.      QUICKUP.TXT   -- Quick and Dirty installation instructions.
  152.      REGISTER.TXT  -- Information and registration form...This will
  153.                       give you a personalized door, voice or bbs
  154.                       support services, new issues of BTREK.DAT
  155.                       files, a clear conscience and a still poor but
  156.                       happy door programmer. Utility Generator to add
  157.                       or delete your own trivia questions.
  158.      DOOR.BAT      -- Sample door batch file
  159.      RUNLOCAL.BAT  -- Run door in local mode to test
  160.  
  161.  
  162.   This ZIP file was created using the -AV function of PKZIP. If my AV is
  163. missing then this file may not be complete or has been tampered with.
  164. Complete and current editions of this program are always available for D/L
  165. on Klingon SoftWare Labs. If the AV is missing please complain to your SysOp
  166. to stop the practice of removing AV's as this is your assurance from the
  167. programmer that the file is complete and virus free.
  168.  
  169.  
  170.                                 ╔════════════╗
  171.                                █║INSTALLATION║
  172.                                █╚════════════╝
  173.                                █████████████
  174.  
  175.   Installation is quite simple and straight-forward. Follow these steps and
  176. examples and you should be up and running in a matter of minutes. Although
  177. Bajoran Trivia is an easy program to install on most any BBS, there may be
  178. some SysOp's who has trouble. Support is available in those situations.
  179.  
  180.       1)  Create a directory to hold all BAJORAN files
  181.  
  182.       2)  Unzip BAJOR201.ZIP into the above directory
  183.  
  184.       3)  Run INSTALL.BAT  <──── Important
  185.  
  186.       4)  Create a configuration file, with a name of your choice
  187.           or modify the SAMPLE.CFG file which is enclosed.
  188.  
  189.       5)  Create a door batch file or use the sample enclosed.
  190.  
  191.       6)  Modify your particular BBS System Menus to add the door. The BBS
  192.           setup varies depending on the type BBS SoftWare you are running. We
  193.           assumed you are familiar with the general DOOR setup on your
  194.           system. Therefore our description includes only examples of the
  195.           BAJORAN specific configuration file and door batch file. Refer to
  196.           your BBS documentation for door installation on your particular
  197.           SoftWare.
  198.  
  199.  
  200.                                ╔══════════════╗
  201.                               █║BBS USER FILES║
  202.                               █╚══════════════╝
  203.                               ███████████████
  204.  
  205.      The BBS user file provides information to BAJORAN, such as COM port,
  206.      user name, time allowed in the door, etc. This file is necessary for
  207.      BAJORAN to function. The complete path\filename of the BBS user file
  208.      must be passed to BAJOR.EXE as the 1st parameter in the command line.
  209.      The user file is created by your BBS EACH time a user runs a door....The
  210.      BBS USER file has a different name on each type of BBS. When you create
  211.      your BAJORAN configuration file, you must tell BAJORAN the name for your
  212.      particular BBS system.
  213.  
  214.             The following is a list of the user files used by the
  215.             BBS types we support (we included a typical path):
  216.  
  217. drive\dir\filename
  218.    C:\WILDCAT\CALLINFO.BBS              ──┐  <- For Wildcat!
  219.    C:\WC30\WCWORK\NODE1\USERINFO.DAT      │  <- For Wildcat! 3.x
  220.    C:\PCB\PCBOARD.SYS                     │  <- For PCBoard using PCBOARD.SYS
  221.                                           │     only
  222.    C:\PCB\USERS                           │  <- For PCBoard using USERS only
  223.    C:\BBS\DOOR.SYS                        │  <- For Systems which support
  224.                                           │     DOOR.SYS
  225.    C:\BBS\DORINFOx.DEF                    │  <- For QBBS/RBB/RA.  Replace x
  226.                                           │     with Node#.
  227.    C:\BBS\TRIBBS.SYS                      │  <- fOR TriBBS
  228.    C:\BBS\SFDOORS.DAT                   ──┘  <- For Spitfire
  229.  
  230.                              ╔══════════════════╗
  231.                             █║CONFIGURATION FILE║
  232.                             █╚══════════════════╝
  233.                             ███████████████████
  234.  
  235.   One (and only ONE) of the above will be LINE 1 of your configuration file.
  236. You MUST specify the path and name (including any extension) correctly if
  237. you expect BAJORAN to find it. Sample for Lines 2 through 10 are:
  238.  
  239.    Klingon SoftWare Labs <──┐   <- Your BBS Name
  240.    Robert                   │   <- SysOp's First Name
  241.    Ferguson                 │   <- SysOp's Last Name
  242.    00000                    │   <- Registration Number
  243.    100                      │   <- Minimum security level allowed
  244.                             │      in door.
  245.    35                       │   <- Maximum questions allowed per visit
  246.                             │      to the door.
  247.    C:\WC\BULL\BULL1.SCR     │   <- Path and Name of Color Bulletin
  248.    C:\WC\BULL\BULL1.BBS     │   <- Path and Name of ASCii Bulletin
  249.    WC                       │   <- WC Create WC!3.x specific bulls
  250.                             │      PCB Create PCBoard specific bulls
  251.                             │      Blank for ANSI & ASCii
  252.    2                        │   <- Number of times allowed to play door
  253.                             │      each day.
  254.    RIP                      │   <- "RIP" create RIP bulletins
  255.                             │      "N" do not create RIP bulls
  256.                             │
  257.    15 <─────────────────────┘   <- Number of seconds to allow the user
  258.                                    to answer each question.  The door
  259.                                    will accept a timeout as an incorrect
  260.                                    answer.  The door defaults to 10
  261.                                    seconds.
  262.  
  263.    Edit the SAMPLE.CFG file to suit your individual BBS. You MUST have all 13
  264.    lines and no extra characters.
  265.  
  266.    Line 1:  This line points to where BAJOR.EXE will find the callers
  267.             information file. Just include the line that your particular BBS
  268.             uses. DO NOT put all of them in the CFG file.
  269.  
  270.    Line 2:  Place the name of your BBS on this line.
  271.  
  272.    Line 3:  SysOp's first name goes here.
  273.  
  274.    Line 4:  SysOp's last name goes here.
  275.  
  276.    Line 5:  Your Registration Number goes here if registered.  If
  277.             you haven't registered you can still use the
  278.             door...just enter 00000 until you get your registration
  279.             number.
  280.  
  281.    Line 6:  The minimum security level that is allowed in the door.
  282.  
  283.    Line 7:  Maximum number of questions allowed per visit to the door.
  284.             I would suggest 25-30 as a reasonable number.  The smaller
  285.             this number, the more likely that the users will continue to
  286.             use the door.
  287.  
  288.    Line 8:  Enter the complete path and name of the ANSI bulletin
  289.             that you want BAJORAN to create.
  290.  
  291.    Line 9:  Enter the complete path and name of the ASCii bulletin
  292.             that  you want BAJORAN to create.
  293.  
  294.    Line 10: "WC" to create WC!3.x specific bulletins or NO for ANSI and
  295.             ASCii bulletins. "PCB" on this line will enable the program
  296.             to create PCBoard specific color bulletins.  If you Config
  297.             for WC! or PCB bulletins, Place the name of the bulletin
  298.             on Line 8 of the CFG file.  Be sure to add the ".BBS"
  299.             extension to it.  You may leave Line 9 blank but it still
  300.             MUST be included in the CFG file.
  301.  
  302.    Line 11: Number of times users are allowed to enter the door each
  303.             day.
  304.  
  305.    Line 12: Place "RIP" on this line if you wish to create RIP styple
  306.             bulletins.  If you do not support or need them, place an
  307.             "N" on this line.
  308.  
  309.    Line 13: Place the number of seconds that you wish to allow to
  310.             answer each question.
  311.  
  312.  
  313.   If you use the sample CFG file be sure to remove all remarks and use a
  314. pure ASCII editor such as EDLIN or QEDIT. Word processors typically leave
  315. hidden control codes. Those hidden codes could cause the program to depart
  316. to worlds unknown. Save your newly edited file using any name you want.
  317.  
  318. DONOR.CL  Registered Users may create a file named DONOR.CL and place it
  319.           in the door directory. If found, the door will display a prompt
  320.           thanking them for donating the door.
  321.  
  322.                               ╔═══════════════╗
  323.                              █║DOOR BATCH FILE║
  324.                              █╚═══════════════╝
  325.                              ████████████████
  326.  
  327.   Create a batch file or modify the sample BAJORAN.BAT file supplied. This is
  328. what you need:
  329.  
  330.   @ECHO OFF
  331.   CLS                     Keeps a clean screen (optional)
  332.   CD \DOORS\BAJORAN       Change to the BAJORAN door files directory
  333.   BAJOR BAJOR1.CFG        Run BAJORAN using BAJOR1.CFG configuration Change
  334.                           back to the WCAT BBS directory
  335.                           Restart the BBS.  On BBSs which shell to
  336.                           dos to run the door this line may be
  337.                           omitted or maybe the word "EXIT."  Check
  338.                           your BBS door instructions.
  339.  
  340.   The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
  341. of TERMINATE for doors.
  342.  
  343.                                ╔══════════════╗
  344.                               █║MULTIPLE NODES║
  345.                               █╚══════════════╝
  346.                               ███████████████
  347.  
  348.   Create a configuration file for each node. Each file should have a unique
  349. name.
  350.  
  351.         EX: BAJOR1.CFG  BAJOR2.CFG
  352.  
  353.   BAJORAN has been tested under LiveCat! and DESQVIEW and performs very well
  354. under either or both.
  355.  
  356.                                ╔═══════════════╗
  357.                               █║COMM PORT IRQ's║
  358.                               █╚═══════════════╝
  359.                               ████████████████
  360.  
  361.   BAJORAN is written using DoorFrame. DoorFrame supports COM 1-4 on the
  362. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2 and COM4
  363. use IRQ3. If your system uses a non-standard IRQ, add the IRQ  number after
  364. the configuration filename. Let's assume your Door is called FOOBAR and you
  365. want to use COM1 but non-standard IRQ5. The command line  passed to your Door
  366. would be:
  367.  
  368.                              FOOBAR FOOBAR.CFG /5
  369.                              FOOBAR FOOBAR.CFG *5
  370.  
  371.   The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 normally
  372. used with COM1. No /x parameter is needed for the standard IRQ's.
  373.  
  374.                            ╔═════════════════════╗
  375.                           █║Fossil Driver Support║
  376.                           █╚═════════════════════╝
  377.                           ██████████████████████
  378.  
  379.  
  380.   BAJORAN supports the use of Fossil drivers.  To tell your Door to use the
  381. Fossil driver instead of the standard COM ports, just put /FD on the command
  382. line when running the door. For example:
  383.  
  384.                             MYDOOR MYDOOR.CFG /FD
  385.                             MYDOOR MYDOOR.CFG *FD
  386.  
  387.   indicates that a Fossil driver is present and should be used. If no Fossil
  388. driver is detected, BAJORAN will print a message to that effect and exit
  389. the door gracefully.
  390.  
  391.                                ╔══════════════╗
  392.                               █║TIPS AND TRAPS║
  393.                               █╚══════════════╝
  394.                               ███████████████
  395.  
  396.   Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC files if they
  397. are included in the package. They sometimes contain some very useful
  398. information. Of course you can do like me, just set the darn thing up
  399. without the docs then fuss at the door author for not making it simple
  400. enough to work the first time.
  401.  
  402.   IF You get an error...check every path to make sure you typed it correctly.
  403. Check the file name...does it match exactly? Does the configuration filename
  404. match? Did you leave off the configuration file extension? Do you have the
  405. correct BRUN module in a directory on your path? If all those seem correct
  406. and the door still won't work...call me......preferably not in the middle
  407. of the night...no door is that important.
  408.  
  409.   When the door is in use...you can use the SysOp options listed at the
  410. bottom of your screen to chat, increase or decrease the user's time or log
  411. the user off.
  412.  
  413.                             ╔═══════════════════╗
  414.                            █║MISCELLANEOUS NOTES║
  415.                            █╚═══════════════════╝
  416.                            ████████████████████
  417.  
  418.   DoorFrame requires DOS 3.x and up since all files are opened in SHARED
  419.   mode.
  420.  
  421.   When using PCBOARD.SYS, BAJORAN requires that PCBOARD.DAT be in the same
  422.   directory as PCBOARD.SYS. BAJORAN also accesses the USERS file.
  423.  
  424.   When using USERS.SYS, BAJORAN also accesses PCBOARD.SYS, PCBOARD.DAT and
  425.   the USERS file.
  426.  
  427.   The DOOR.SYS used by BAJORAN is the standard 52 line GAP (tm) file.
  428.  
  429.   The CALLINFO.BBS used by BAJORAN currently contains 36 lines.
  430.  
  431.   DoorFrame doors may now make use of the IRQ environment variable. For
  432. example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
  433. (I use this method here on Klingon SoftWare Labs BBS for WC! and it works
  434. just fine. Use "/%WCIRQID%".)
  435.  
  436.   DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
  437. %PCBDIR%. If it finds those two variables on the first line of the .CFG
  438. file it will substitute the correct drive and path.
  439.  
  440.                                  ╔══════════╗
  441.                                 █║LEGALITIES║
  442.                                 █╚══════════╝
  443.                                 ███████████
  444.  
  445.   THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"  WITHOUT
  446. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  447. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS  FOR A PARTICULAR PURPOSE.
  448. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  449. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  450. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  451.  
  452.                                 ╔════════════╗
  453.                                █║DISTRIBUTION║
  454.                                █╚════════════╝
  455.                                █████████████
  456.  
  457.   You may make this file available for downloading from your BBS or you may
  458. upload it to any BBS of your choice, provided that you do not make any
  459. changes to the contents of the archive (ZIP file). The archive and its
  460. individual contents may not be used by any service that charges any money
  461. whatsoever, without the written permission of the author.
  462.  
  463.                                 ╔════════════╗
  464.                                █║REGISTRATION║
  465.                                █╚════════════╝
  466.                                █████████████
  467.  
  468.   I am not a subscriber to the "CrippleWare" concept, and this program
  469. reflects that philosophy. This is a full-featured program, whose
  470. functionality is not hampered in any way, whether you register it or not.
  471. It is only $15 to register this door. Registered SysOps will receive an
  472. added utility that will allow you to edit and/or add questions to the
  473. database. There is a 10 second delay that is removed once the program has
  474. been registered.
  475.  
  476.                                    ╔══════╗
  477.                                   █║THANKS║
  478.                                   █╚══════╝
  479.                                   ███████
  480.  
  481.   A *VERY SPECIAL THANKS!* to Dennis Maidon of PAROLE SoftWare Technologies.
  482. Without him, this door game would be non-existant. You're "SECOND-TO-NONE"
  483.  
  484.   This game is dedicated to my 3yr old daughter Zenobia S. Ferguson and my
  485. 5yr old daughter Anye' Y. Moore - "Daddy's Little Klingons."
  486.  
  487.   Gene Roddenberry Who made a difference in my life, Thank you for Star Trek.
  488. batlh Daqawlu'taH - "You will be remembered with honor."
  489.  
  490.                                     Qapla'
  491.