home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / v611docs.zip / VMAIN611.ZIP / V-J < prev    next >
Text File  |  1993-10-08  |  35KB  |  687 lines

  1.                                              VBBS 6.11 Documentation -- J-1
  2.  
  3.  
  4.          ╔════════════════════════════════════════════════════════════════╗
  5.          ║ APPENDIX J        VBBS Doors Documentation                     ║
  6.          ╚════════════════════════════════════════════════════════════════╝
  7.  
  8.      GENERAL INFORMATION 
  9.      ═══════════════════
  10.    
  11.          1 - Dropfiles
  12.  
  13.         Dropfiles (DF) are the link between the BBS and the game 
  14.      itself.  A DF contains all of the required info for the game to 
  15.      operate properly.  This includes the user's "handle" (so he al-
  16.      ways uses the same slot in the game), the user's COM port & speed
  17.      (so the game knows where to send the data), and other miscellan-
  18.      eous info - the BBS name, sysop name, user's time remaining (on 
  19.      the BBS), etc.
  20.  
  21.      Here is a list of many of the common dropfile formats:
  22.  
  23.         Types          Original BBS format     VBBS Supported?
  24.        -----------------  ----------------------   ---------------
  25.          CALLINFO.BBS     Wildcat! 2.x                  No
  26.         CHAIN.TXT     WWIV                          Yes
  27.          DOOR.SYS     Wildcat! 3.x & Others         Yes
  28.          DORINFOx.DEF     QBBS / RBBS                   Yes
  29.           PCBOARD.SYS     PC Board                      No
  30.           SFDOORS.DAT     Spitfire                      No
  31.  
  32.                 At the present time VBBS supports the CHAIN.TXT, DORINFOx.DEF
  33.           and DOOR.SYS dropfiles.  They are fairly simple to use; the only one
  34.           needing an extended explanation is the DORINFOx.DEF.  All the drop-
  35.           files are created in your \VBBS directory.
  36.  
  37.                 The 'x' in DORINFOx.DEF is the node number that the user is 
  38.           logged in on.  On a single-line system this will always be a '1',
  39.           the normal local node would be a '0', and node 2 would be a '2'.
  40.           Many of the newer games that are coming out allow for multiple 
  41.           players in the game at the same time, and some even allow inter-
  42.           action between the players.  Almost all of these games require 
  43.           the DORINFOx.DEF dropfile.
  44.  
  45.                 The DOOR.SYS dropfile is a fairly generic dropfile accessible
  46.          to many games and is VERY common.   It requires no special work to 
  47.          use with a game.  The CHAIN.TXT dropfile is used predominantly by 
  48.          WWIV-based doors, and most can be used with VBBS (see section 3.3 
  49.          for more information.)
  50.  
  51.  
  52.          2 - FOSSIL Drivers
  53.  
  54.         FOSSIL drivers are external TSR's that handle carrier de-
  55.          tection routines for programs that cannot do it themselves.  You
  56.          do not HAVE to use a FOSSIL driver for all games, so you do not
  57.          have to load one at start-up (unless your modem configuration 
  58.          requires one.)  Sometimes they are required if you are using a 
  59.          high-speed modem, but this DOES vary.
  60.  
  61.                                              VBBS 6.11 Documentation -- J-2
  62.  
  63.                 The two most commonly used FOSSIL drivers are BNU and X00.
  64.          Both allow installation before running a door and removal afterwards.
  65.          See section 4.2 for information or where you can get these pro-
  66.          grams. You will want to go through the documentation files on the 
  67.          FOSSIL driver for specific installation information, as the setup
  68.          varies widely based on the hardware used.
  69.  
  70.  
  71.          Preparation, Installation, and Execution
  72.          ════════════════════════════════════════
  73.  
  74.          1 - Game Files
  75.  
  76.                 Installing the game onto your system is the first step to-
  77.          wards getting it to work.  The first thing you should do when you 
  78.          get a new game is unZIP/deARJ/unPAK/whatever the compressed file
  79.          is into its own directory.  Then load up your favorite text edi-
  80.          tor/viewer and read the sysop documentation.  Almost all ques-
  81.          tions can be answered with the docs included with the games.
  82.          While you are reading, take note of the following information:
  83.  
  84.          Installation - does this program self-install?
  85.                       - does this program need to be in a special
  86.                         directory to run?
  87.                       - does this program have a configuration file
  88.                         that needs to be made / altered?
  89.                       - how do you initialize the game files?
  90.          Dropfiles    - does it use one of the 3 supported by VBBS
  91.                         or does it require a special dropfile?
  92.          FOSSIL Driver- Is one needed for this program to run?
  93.          Command Line - Quite often there are MANY switches that
  94.                         can be used on the command line. Make SURE
  95.                         that you note ALL the possible switches.
  96.                       - Major switches to look for are:
  97.                             Dropfile Type              Dropfile Path
  98.                             FOSSIL (Y/N)               Node Number Info.
  99.                             Configuration Filename     Local Play Mode
  100.  
  101.                 Before you continue, make sure the game will support one 
  102.          of the three dropfiles that VBBS supports (either DOOR.SYS, 
  103.          DORINFOx.DEF, or CHAIN.TXT.)  If it does not then there are two 
  104.          other ways you can get the game to run with your BBS.
  105.  
  106.          1> Get a Door Converter program - these programs allow you to
  107.             take a dropfile that you already have (ie DOOR.SYS) and run 
  108.             it through the converter to produce a different dropfile for-
  109.             mat (see section 3.2 for more detailed information).
  110.  
  111.          2> Some games allow you to create your own dropfile for use with
  112.             the game.  If it is possible to do so then all you need to do
  113.             is write down the information that has to appear in the file
  114.             and the order it must appear.  You can then either write up a
  115.             script or a batch file to create the new dropfile for the game.
  116.  
  117.                                              VBBS 6.11 Documentation -- J-3
  118.  
  119.  
  120.                 If neither of these options are available then place the game
  121.          on a floppy for storage and check to see if any local (or network)
  122.          sysops can give you a hand. The most important rule when setting
  123.          up a game is 'Ask Lots Of Questions.'  If you cannot find the an-
  124.          swers in the docs, then you NEED to ask someone else. Do not give
  125.          up on the game if it does not seem to work when it is first in-
  126.          stalled, many games require a bit of fine-tuning to match your 
  127.          specific system setup.
  128.  
  129.                 At this point run any installation program (if supplied) 
  130.          and fill in the required information.  Remember to write down any
  131.          information that the program gives you during the installation.
  132.  
  133.                 Most doors require you to modify a configuration file.  You
  134.          can do this with your favorite text editor and make any changes
  135.          required.  Note: Make a back-up copy of this file before you make
  136.          the changes!  These changes normally entail inserting your BBS's
  137.          name, the sysop's name, any file paths that don't match the de-
  138.          faults, etc. If the program allows multi-line use and requires a
  139.          separate file for the configuration of each line, then make sure
  140.          to make as many copies as you need (changing the filename) and 
  141.          then edit in the information that needs to be different between 
  142.          each configuration file.
  143.  
  144.                 Once the program is installed, you should perform initial-
  145.          ization of the game files (if that is required) before continuing
  146.          on to the next step.  This will allow you to immediately go into 
  147.          the game to see if you have everything set up properly.  If the 
  148.          game has a 'LOCAL' mode, try to run it at this point.  This will 
  149.          allow you to test for any bugs in the configuration as far as the
  150.          game files are concerned.  After the 'local' bugs are taken care 
  151.          of you will then want to move on to the next section.  It is re-
  152.          commended that you do not make the door open to all your users 
  153.          until you have had a friend (or fellow sysop) call from remote
  154.          to test the modem end of it.
  155.  
  156.  
  157.          2 - Batch Files
  158.  
  159.                 The single most important part of getting a door to run is
  160.          having the correct batch file setup.   Not all games require a 
  161.          batch file to run, but we strongly recommend that you do use them 
  162.          for every door. It makes it easier to find problems, and allows 
  163.          far more versatility. You may also be required to create batch 
  164.          files for running the nightly maintenance for the game.  Both 
  165.          files are covered here.
  166.  
  167.              A - Game Batch Files
  168.  
  169.                 This is where the information you took down on the command
  170.          line comes in handy.  You need to determine what switches will be
  171.          required, and you will also have to discern if you need more than
  172.          one batch file.
  173.  
  174.                                              VBBS 6.11 Documentation -- J-4
  175.  
  176.  
  177.          Here is an example batch file (most will be similar in format):
  178.  
  179.          DUMBGM.BAT
  180.  
  181.                 Line 1-> @echo off
  182.                 Line 2-> c:
  183.                 Line 3-> cd c:\vbbs\games\dumbgame
  184.                 Line 4-> dumbgame /pc:\vbbs\ dumbgm1.cfg
  185.                 Line 5-> cd c:\vbbs
  186.  
  187.          Line 1 -> Not required, turns off screen output of the batch
  188.                    file. Note: If you are not using DOS 5.0 you cannot
  189.                    use the @ symbol (so the line would read 'echo off')
  190.  
  191.          Line 2/3->Just a precaution to make absolutely SURE you are on
  192.                    the correct drive and in the right directory.  Not
  193.                    required, but a GOOD thing to do in ALL batch files.
  194.  
  195.          Line 4 -> Actual game command line.  This game requires the
  196.                    program name followed by a '/p' and the path to your
  197.                    dropfile (which is ALWAYS the \VBBS directory.) and
  198.                    then the name of the configuration file it is going
  199.                    to use (if this game was run on node 2 the config file
  200.                    would be dumbgm2.cfg)
  201.  
  202.          Line 5 -> This is just another 'make sure' line to restore the
  203.                    system to the right directory.  If you do NOT return to
  204.                    the \VBBS directory after running an external program
  205.                    you will have empty files and CONTROL.DAT files popping
  206.                    up all over your hard drive.  These files are harmless
  207.                    and can be deleted, but they are a pain.
  208.  
  209.                 While most batch files will contain more 'meat' they will
  210.          usually follow the same basic structure.  Again, refer to your sysop
  211.          docs that came with the game for more detailed information.
  212.  
  213.                 A final note on batch files.  If a door requires a differ-
  214.          ent command line when being run off of different nodes (hence
  215.          multiple batch files) you should give the batch file a name of 1
  216.          to 7 characters followed by the number of the node that the batch
  217.          file is for.  The command to run the game would then be the file-
  218.          name followed by a %1.  For example, the command line 
  219.  
  220.                'C:\VBBS\DUMBGM%1' 
  221.  
  222.          would run the files as follows:
  223.  
  224.                 User on Node 0  --- Filename: DUMBGM0.BAT
  225.                 User on Node 1  --- Filename: DUMBGM1.BAT
  226.                 User on Node 4  --- Filename: DUMBGM4.BAT
  227.  
  228.                 Some games that require you to use a FOSSIL driver and have a
  229.          'local' switch will require a different batch file for remote and
  230.          local play.  If a game does require a separate file for local play
  231.          (and it does NOT use a dropfile to do so) you may NOT be 
  232.  
  233.                                              VBBS 6.11 Documentation -- J-5
  234.  
  235.  
  236.          able to do a <L>og-in Local from the WFC screen because the pro-
  237.          gram will not detect a carrier and then exit.  That style of game
  238.          will require you to use the local node (Node 0) to play.
  239.  
  240.  
  241.              B - Maintenance Batch Files
  242.  
  243.                 Some games require that you run a special program at the
  244.          end of each day.  These programs do things like updating high 
  245.          score files, maintenance on the game universe, and sometimes 
  246.          making backups of the data files.  Any game that requires such
  247.          maintenance will list the command line information in their re-
  248.          spective doc files.  All you need to do is create a batch file 
  249.          resembling your game batch file, except that it will contain the
  250.          maintenance command line.  At this point you have two ways to 
  251.          implement the nightly maintenance:  either set it up as an indi-
  252.          vidual nightly event or make a master batch file that runs all of
  253.          your nightly maintenance at one time.
  254.  
  255.                 No matter which way you choose to do it, you must first 
  256.          create the maintenance file.  All you have to do is create a
  257.          batch file following the same structure as your game batch, but
  258.          using the command line that the game docs require for the main-
  259.          tenance portion.  If you are going to run each individually then
  260.          you are done with file work at this point.
  261.     
  262.                 If you wish to run all of your maintenance at once, then you
  263.          should take all of your maintenance batch files and place them 
  264.          all into one BIG batch file.
  265.  
  266.                 At this point you need to go to your \VBBS directory and run
  267.          the VCONFIG program.  Select option '8. Events Configuration' and you
  268.          will be shown a screen like this:
  269.  
  270.                 ## Time  Last Run  Command line
  271.  
  272.                 A)dd Event E)dit Event Esc) Quit
  273.  
  274.          Select [A]dd Event and the cursor will be placed under the Time 
  275.          section of the first blank line.  Enter the time that you wish to
  276.          run the batch file and remember it is in Military Time (00:01 to 
  277.          23:59.)  The last run section should be left blank by just hit-
  278.          ting [Enter] at this point.  The command line is where you type 
  279.          the complete path and filename to the batch file you wish to run.
  280.          If you are running each file individually you will need to add 
  281.          one new event for each file, although it is best to only use one
  282.          large file for maintenance because each time it runs an event it
  283.          has to reload the BBS and initialize the modem, which is just
  284.          extra work for the system to do.  If you have any questions on 
  285.          events then just see VBBS560.DOC - EVENTS Configuration for more
  286.          information.
  287.  
  288.                                              VBBS 6.11 Documentation -- J-6
  289.  
  290.  
  291.          3 - Interfacing with the BBS
  292.  
  293.                 And now we get to the fun part -- actually installing the
  294.          games into your BBS.  There are 3 different ways you can load a 
  295.          door; from the VBBS door config, from a script, or from a func-
  296.          tion block.  Each has its own merits and each will be covered in
  297.          turn.
  298.  
  299.              A - VBBS Door Configuration Menu
  300.  
  301.                 VBBS comes complete with a built-in door handling area.
  302.          The door area places all the games in one section, allows you to
  303.          place certain restrictions on access, and gives the option for 
  304.          using a credit system.  It also offers the easiest setup of the
  305.          three methods:
  306.  
  307.             Load up VCONFIG.EXE from the \VBBS directory.
  308.             Enter the VCONFIG section 'A. Doors Configuration.'
  309.             Select [F1] to add a 'New Game' line to the menu.
  310.             Move the highlight bar over the 'New Game' line and hit 
  311.                 [ENTER].
  312.  
  313.             You will now see the following screen:
  314.  
  315.                         1. Program Name: New Game
  316.                         2. Command Line:
  317.                         3. Security Lvl: 255
  318.                         4. Access Flag:
  319.                         5. Single User:  Yes
  320.                         6. Credit Cost:  0
  321.  
  322.                         D)elete This Entry
  323.  
  324.                         [ESC] to quit
  325.  
  326.          1. Program Name: -> This is what the user will see when he enters
  327.                              your doors area.
  328.          2. Command Line: -> This is what you will use to run the game. If
  329.                              you are using a batch file, all you need to 
  330.                              have is the COMPLETE path to the batch file 
  331.                              and the batch filename (no extension).  If
  332.                              the program has a different batch file for
  333.                              each NODE on your BBS then the batch file 
  334.                              name would be listed like this:
  335.  
  336.                                  C:\VBBS\BATCH\DUMBGM%1
  337.  
  338.                              The %1 tells VBBS to place the node # at the 
  339.                              end of the filename, thereby using the proper
  340.                              batch file for each node.
  341.          3. Security Lvl: -> This is the minimum security level (SL) nee-
  342.                              ded to play this game.  It is set to 255 by 
  343.                              default.  You should leave it at that until 
  344.  
  345.                                              VBBS 6.11 Documentation -- J-7
  346.  
  347.  
  348.                              you are ready to have it tried from remote.
  349.                              See VBBS560.DOC for more info on security 
  350.                              levels.
  351.          4. Access Flag:  -> This is the access flag required to play this
  352.                              game.  NOTE: Access flags (also called "H
  353.                              flags") are the flags that are set in the
  354.                              user editor by pressing the [H] key.  They
  355.                              are NOT the general flags.  If this field
  356.                              is blank then anyone with the proper SL (or 
  357.                              higher) can access this game.  If this has a
  358.                              letter in it (and it can use from A to Z)
  359.                              then the user must ALSO have the flag ON 
  360.                              (listed in his Uedit screen).  This is use-
  361.                              ful for games that you only want certain 
  362.                              people to have access to, including game edi-
  363.                              tors and such.  See VBBS560.DOC for more info
  364.                              on access flags.
  365.          5. Single User:  -> Set to YES if only one person can be playing
  366.                              at once, set to NO if it is a multi-player 
  367.                              game.  Most multi-player games require that
  368.                              DOS's SHARE is loaded into memory before they
  369.                              can be run.  If this is the case you will 
  370.                              need to add it to your AUTOEXEC.BAT file.
  371.          6. Credit Cost:  -> This allows you to set an individual cost in
  372.                              credits per game.  See VBBS560.DOC and
  373.                              VSCRIPT.DOC for more info on the credit system.
  374.  
  375.              B - Script Installation
  376.  
  377.          Script : Any program created using VBBS' script language.
  378.                   All scripts have the .V extension, are located in the
  379.                   script directory (see VBBS560.DOC - PATHS Configuration)
  380.                   and are compiled with VCOM.EXE (see VSCRIPT.DOC for
  381.                   more info.)  Remember that any time you make changes
  382.                   to a script, you MUST recompile it.
  383.  
  384.                 Installing in a script can be simple or complex, depending
  385.          on the type of setup you would like to have.  Due to space con-
  386.          straints, only the actual running of a single door from within a
  387.          script will be covered.
  388.                 For running more than one door, you would need a script
  389.          for each door.
  390.  
  391.          *** Special Note ***
  392.     
  393.          Before you attempt to create the script you SHOULD read through
  394.          the VSCRIPT.DOC to become familiar with the script commands.
  395.  
  396.          When setting up a door from within a script you need to decide
  397.          how you would like to run, for lack of a better term, the 'loop
  398.          stop'.  When you exit a door that was loaded from a script, the
  399.          system returns to the first line of the script, thereby creating
  400.          an endless loop.  To avoid this, you have one of two options:
  401.  
  402.                                              VBBS 6.11 Documentation -- J-8
  403.  
  404.  
  405.          use either an $Extra variable or a $Flag.  Both formats will be
  406.          covered here.
  407.  
  408.          When using an $Extra variable:
  409.  
  410.          DUMBGAME.V
  411.     
  412.          test $extra2 = DumbGame exitgame        <--- This line tests to 
  413.                                                       see if they just re-
  414.                                                       turned from the game.
  415.          setextra 2 "DumbGame"                   <--- This sets the 'loop
  416.                                                       stop'.
  417.          $gametoplay = "c:\vbbs\batch\dumbgm%1"  <-These lines run the ac-
  418.                                                    tual door.
  419.          door $gametoplay                       <-Remember that the %1 is
  420.                                                   the node number VBBS adds
  421.                                                   to the command line. If
  422.                                                   you do NOT need to have 
  423.                                                   multiple batch files,
  424.                                                   then do not use the %1.
  425.          # exitgame                             <--- These last lines turn
  426.          $blnk = " "                                 off the 'loop stop'
  427.          setextra 2 $blnk                            so the user can play
  428.                                                      the game again.
  429.          exit start                             <--- This is the line that
  430.                                                      sends the user back to
  431.                                                      the function block 
  432.                                                      that he/she came from.
  433.  
  434.          When using a $Flag
  435.  
  436.          $q = $flags instr N               <--- These two lines do the same
  437.          testval $q <> 0 exitgame               thing that the 'test' line
  438.                                                 above does.
  439.          setflags N on                     <--- This turns on the 'loop 
  440.                                                 stop'
  441.          $gametoplay = "c:\vbbs\batch\dumbgm%1" <--- as same commands above
  442.          door $gametoplay                       <---
  443.          # exitgame
  444.          setflags N off                         <--- Turns 'loop stop' off
  445.          exit start                             <--- as same command above
  446.  
  447.                 You will need to run VCOM to compile the scripts you have
  448.          written into code that VBBS can use.  You compile by using the command
  449.          line
  450.  
  451.                 VCOM <script name> 
  452.  
  453.          while at the DOS prompt and in your scripts directory.  If there
  454.          are any errors it will let you know.  The compiler aborts after
  455.          the first error, so there may be more than one.  Lastly, go into
  456.  
  457.                                              VBBS 6.11 Documentation -- J-9
  458.  
  459.  
  460.          your function block (START.FB in the examples above) and add the
  461.          following line on any but the first two lines in the .FB file:
  462.  
  463.                 Z 001 2 Dumbgame
  464.                 |  |  |   ^------This is the script name, NO extension
  465.                 |  |  ^----------This is the code to tell VBBS it is run-
  466.                 |  |              ning a script
  467.                 |  ^-------------This is the SL to be able to use the key
  468.                 |                 (and run the script).
  469.                 ^----------------This is the key to press at the menu to
  470.                                  load and run the script.
  471.  
  472.              C-Function Block Installation
  473.  
  474.          Function Block: File containing the commands for each menu of the
  475.                          BBS.  All FB's have the extension .FB and are 
  476.                          placed in the script directory (see VBBS560.DOC
  477.                          -- PATHS Configuration and VSCRIPT.DOC for more
  478.                          info.)
  479.  
  480.                 All you need to do is select the function block that you 
  481.          wish to add the game to, pull up the .FB with your text editor 
  482.          and add the command using the following format.
  483.     
  484.          Note: Do NOT place this command on the 1st or 2nd line of the
  485.                function block, as those are reserved for other info.
  486.  
  487.          Z 001 4 c:\vbbs\batch\dumbgm%1
  488.          |  |  |   ^------This is the complete path to the batch file 
  489.          |  |  |          and the filename to be run.
  490.          |  |  ^----------This is the code to tell VBBS it is running a 
  491.          |  |             command that it needs to shrink the BBS out of
  492.          |  |             memory for it to run.
  493.          |  ^-------------This is the SL to be able to use the key (and
  494.          |                run the door.)
  495.          ^----------------This is the key to press at the menu to load 
  496.                           and run the door.
  497.  
  498.                 If you wish to create a separate function block just for 
  499.          games, then you will need to create a new set of menus for it as
  500.          well as create the .FB file.  For specific information read the
  501.          VSCRIPT appendix.
  502.  
  503.                                              VBBS 6.11 Documentation -- J-10
  504.  
  505.  
  506.          Programs and Utilities
  507.          ══════════════════════
  508.  
  509.  
  510.          1 - DoorWay
  511.  
  512.                 DoorWay is a program written by Marshall Dudley to assist
  513.          in the setting up and running of almost ANY program through a 
  514.          modem.  There are many different ways to use DoorWay, but the 
  515.          single most common use is to access the DOS prompt from a remote
  516.          computer.  Here is a simple setup for using DOORWAY.EXE for this
  517.          purpose.  NOTE: The DoorWay files come compressed and include
  518.          the DOORWAY.DOC file explaining all the switches used.  You will
  519.          need to do some fine-tuning with ANY program that you set up
  520.          using the DOORWAY.EXE, so keep a copy of the doc file handy!!
  521.  
  522.          1> Get a copy of DoorWay v2.05 or higher and place the main
  523.             executable file (DOORWAY.EXE) either in your path or directly
  524.             into your \VBBS directory.  (The latter is best, however.)
  525.  
  526.          2> Load up your SYSOP.FB file and add the following command line
  527.             to it:
  528.  
  529.                 A 255 4 SHELL.BAT
  530.                 ^------------------Use any character not already in
  531.                                    the SYSOP.FB.
  532.  
  533.          3> In your \VBBS directory create this batch file:
  534.  
  535.                 SHELL.BAT
  536.      
  537.          Line 1 -> @echo off
  538.          Line 2 -> DOORWAY SYS /G:ON /V:B^U /M:1000 /B:MSZ /C:DOS
  539.  
  540.                 The program has many useful applications, and can often
  541.          make the difference in whether you can get a game to run on your
  542.          BBS or not. Just remember, DoorWay allows ANY program to be run
  543.          as a door; it does not have to be a program written specifically
  544.          for a BBS.
  545.  
  546.  
  547.          2 - DoorMaster
  548.  
  549.                 DoorMaster(DM) is a program written by Michael P. Otto to
  550.          convert the various dropfile formats into any of the other for-
  551.          mats. It supports the dropfiles created by 52 different software
  552.          packages (see the DM docs for the actual listing.)  Use of this
  553.          program will allow you to use a game that requires a dropfile 
  554.          format that is not currently supported by VBBS directly (like 
  555.          WildCat 2.x's CALLINFO format.)  You will need to read the docu-
  556.          mentation for the actual command lines as the program has a very
  557.          extensive set of commands available.
  558.  
  559.                                              VBBS 6.11 Documentation -- J-11
  560.  
  561.  
  562.          3 - VReturn/WWIVDoor
  563.  
  564.          DOS Interrupts: Codes required by certain games to function.
  565.                          These games were written as WWIV doors and 
  566.                          cannot be run on VBBS without a program called
  567.                          VRETURN (see below for more information on 
  568.                          VRETURN).  NOTE: This only applies to games that
  569.                          require the CHAIN.TXT dropfile to run.  VBBS
  570.                          supports many common dropfile formats and almost
  571.                          all door programs give you options for the type
  572.                          dropfile to place in the configuration during
  573.                          setup or installation.
  574.  
  575.  
  576.                 VRETURN is a program used to intercept the calls to the
  577.          DOS interrupts and allow the game to run without actually using
  578.          the interrupts.  VRETURN is available to any registered WWIV 
  579.          sysop, although there is a version that is not based on the WWIV
  580.          code that is being written at this time (check any local Vir-
  581.          tualNet BBS for information on this program).
  582.  
  583.                 WWIVDoor is an accessory program to VRETURN that allows
  584.          easier use of all WWIV-style doors.  It automatically calls on 
  585.          VRETURN to handle the DOS interrupts and also handles any local
  586.          logins to bypass the carrier detection phase of the game being 
  587.          used.  WWIVDoor is written by Scott C. Duensing and includes all
  588.          the general information you will need to run any of the various
  589.          WWIV-style doors using this program.
  590.  
  591.  
  592.          4 - Virtual ToolKit
  593.  
  594.                 The Virtual ToolKit is a programming assistant for use 
  595.          in the writing of single or multi-node games for use with VBBS.
  596.          The ToolKit is presently available for VBBS-DOS and a special
  597.          version will soon be available for use with VBBS-OS/2.  There 
  598.          are very few games written specifically for OS/2, so this new 
  599.          VTK will open up some opportunities for all you game programmers
  600.          out there.  The VTK's are available only thru the VBBS author;
  601.          please see the Registration Form for more info.
  602.  
  603.                                              VBBS 6.11 Documentation -- J-12
  604.  
  605.  
  606.          Miscellaneous Information
  607.          ═════════════════════════
  608.  
  609.          1 - Enhancements
  610.  
  611.                 There are many different scripts and source modifications
  612.          written to improve the versatility of the on-line games area. The
  613.          changes that are made with these 'programs' include multiple game
  614.          topics, special restricted areas, and other visual changes and 
  615.          improvements.
  616.  
  617.                 Other enhancements that you can use include modifying your
  618.          batch files to create lists of games played.  You can copy the 
  619.          games' high-score files into your text directory to create entire
  620.          bulletin sections that are made up of your game scores.
  621.  
  622.          2 - Copyright Information & Distribution Sites
  623.          ══════════════════════════════════════════════
  624.  
  625.          BNU FOSSIL Driver - Copyright (C) 1989;  David Nugent and Unique
  626.                              Computing Pty Limited;  Melbourne, Australia.
  627.                            - BNU is freeware and is available on many
  628.                              BBSes.
  629.  
  630.          X00 FOSSIL Driver - Copyright (c) 1990 by Raymond L. Gwinn
  631.                              12469 Cavalier Drive, Woodbridge, Virginia
  632.                              22192 All Rights Reserved 
  633.                            - X00 is freeware and is available on many
  634.                              BBSes.
  635.  
  636.          DoorWay - (C)opyright 1987,1988,1989   Version 2.05 - 9-30-89
  637.                         Written by: Marshall Dudley
  638.                                     406 Monitor Lane
  639.                                     Knoxville, TN  37922
  640.                  - DoorWay is shareware and is available on many BBSes as
  641.                    well as on the following official distribution BBS:
  642.                              Data World BBS - (615)966-3574
  643.                              (Sean Dudley - Sysop)
  644.                  - Registration for DoorWay is $30 and is valid for all
  645.                    future releases of the software.
  646.  
  647.          DoorMaster - Copyright (C) 1988,89,90,91,92 by Michael P. Otto,
  648.                                   All Rights Reserved
  649.                                   213 Casalon Drive, Suite 6
  650.                                   O'Fallon, MO  63366
  651.                                   United States of America
  652.                     - DoorMaster is shareware and is available on many
  653.                       BBSes as well as the following official distribution
  654.                       BBS:
  655.                           DataPoint BBS - (314)281-4707
  656.                     - Registration for DoorMaster is $25 and is valid for
  657.  
  658.                                              VBBS 6.11 Documentation -- J-13
  659.  
  660.  
  661.                       all future releases of the software.
  662.  
  663.          WWIVDoor - Copyright 1992 Scott C. Duensing, All Rights Reserved.
  664.                                    312 Las Olas Drive
  665.                                    Belleville, IL  62221
  666.                   - WWIVDoor is freeware and is available on many BBSes as
  667.                     well as on the following official distribution BBS:
  668.                            Snafu Software BBS - (618)234-2631.
  669.  
  670.  
  671.          ═════════════════════════════════════════════════════════════════
  672.  
  673.                 Well, that is all you should need to get almost ANY game 
  674.          up and running with VBBS.  Almost ALL problems you will run into
  675.          are either an error in a command line or a software/hardware in-
  676.          compatibility (which are usually fixable with a FOSSIL driver).
  677.          We can not say it often enough or loud enough --
  678.  
  679.                             ALWAYS READ THE DOCS!!! 
  680.  
  681.          We all hate the time it takes, but it will save you LOTS of head-
  682.          aches later on down the BBSing road.  It is a good habit to have,
  683.          and it pays out some serious dividends as well.
  684.  
  685.          ═════════════════════════════════════════════════════════════════
  686.  
  687.