home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_door / gwar242.arj / SYSOP.TXT < prev    next >
Text File  |  1992-05-14  |  20KB  |  464 lines
  1.                                 GLOBAL WAR
  2.                                 ~~~~~~~~~~
  3.                       Copyright 1989-1992 Joel Bergen
  4.                      ProVision BBS: (206) 353-6966 HST
  5.                        (206) 353-2494 300/1200/2400
  6.                              Fidonet 1:343/65
  7.  
  8.    First of all, let me assure you that if you don't follow these
  9.    instructions, Global War will not work.
  10.  
  11.    Global War must be executed in its own subdirectory.  Your BBS ideally
  12.    should call a batch file which should change to this subdirectory,
  13.    execute the game, change back to your BBS subdirectory, and return to
  14.    your BBS.  If your BBS can't execute a batch file, you may have to
  15.    run the game from your main BBS subdirectory.
  16.  
  17.    For example purposes, this document will assume your main BBS
  18.    subdirectory is named "C:\BBS" and that Global War is in subdirectory
  19.    "C:\BBS\GLOBLWAR".  Substitute your actual subdirectory names if they
  20.    are different.
  21.  
  22. Installing GLOBAL WAR on your system:
  23. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  24.    Make a subdirectory anywhere on your hard disk to contain the GLOBAL
  25.    WAR game (C:\BBS\GLOBLWAR for example).  Put all the files in the
  26.    GLOBAL WAR archive into this directory except WAR.BAT, which you
  27.    should copy into your main BBS directory (C:\BBS for example).
  28.  
  29.    Edit WAR.CFG, following the instructions found in that file.
  30.  
  31.    Now change back to your main BBS directory.  You will need to edit
  32.    WAR.BAT to tell Global War what type of BBS software you're using.
  33.    Global War will work with PCBoard, Wildcat, RBBS, WWIV, QuickBBS, RA
  34.    Spitfire, Searchlight, TAG, Telegard, GAP, Maximus, Genesis Deluxe,
  35.    and any other BBS program that can run doors made for any of these
  36.    BBSs.  Select one of the following installation methods:
  37.  
  38. Global War for RBBS/QBBS/RA (or any system which uses DORINFO1.DEF)
  39. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  40.    RBBS creates a file called DORINFO1.DEF which Global War will read.
  41.    Use the "/R" switch to tell Global War where to look for
  42.    DORINFO1.DEF.  The calling convention is:
  43.  
  44.                 WAR /R d:\path\DORINFO1.DEF
  45.  
  46.    Your WAR.BAT should look something like this:
  47.  
  48.                 ECHO OFF
  49.                 CD \BBS\GLOBLWAR
  50.                 WAR /R C:\BBS\DORINFO1.DEF
  51.                 CD \BBS
  52.  
  53.    Substitute your actual subdirectory names if different.
  54.  
  55.  
  56. Global War for WWIV version 4.20+ (CHAIN.TXT)
  57. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  58. NOTE: CHAIN.TXT was changed in WWIV 4.20.  Global War will not read the
  59. old CHAIN.TXT format from WWIV prior to version 4.20.
  60.  
  61.    WWIV creates a file called CHAIN.TXT which Global War will read. Use
  62.    the "/W" switch to tell Global War where to look for CHAIN.TXT.  The
  63.    calling convention is:
  64.  
  65.                  WAR /W d:\path\CHAIN.TXT
  66.  
  67.    Your WAR.BAT should look something like this:
  68.  
  69.                 ECHO OFF
  70.                 CD \BBS\GLOBLWAR
  71.                 WAR /W %1
  72.                 CD \BBS
  73.  
  74.    Substitute your actual subdirectory names, of course.
  75.  
  76.    Run WWIV, go into Chainedit (hit "C" at WFC) and create a new
  77.    entry for GLOBAL WAR with the following information:
  78.  
  79.                 A. Description     :  GLOBAL WAR!
  80.                 B. Filename        :  WAR.BAT %1
  81.                 C. SL              :  10
  82.                 D. AR              :  None
  83.                 E. ANSI            :  Required
  84.                 F. DOS Interrupt   :  Not Used      <-- IMPORTANT!!
  85.                 G. 300 baud        :  Not allowed       GW will lock up if
  86.                 H. Shrink          :  No                set to "used"
  87.  
  88. Global War for Wildcat! (CALLINFO.BBS)
  89. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  90.    Wildcat! creates a file called CALLINFO.BBS which
  91.    Global War will read.  Use the "/I" switch to tell Global War to
  92.    look for CALLINFO.BBS.  The calling convention is:
  93.  
  94.                 WAR /I d:\path\CALLINFO.BBS
  95.  
  96.    Your WAR.BAT should look something like this:
  97.  
  98.                 ECHO OFF
  99.                 CD \BBS\GLOBLWAR
  100.                 WAR /I C:\BBS\CALLINFO.BBS
  101.                 CD \BBS
  102.  
  103.    Substitute your actual subdirectory names if different.
  104.  
  105.  
  106. Global War for Genesis Deluxe BBS version 4.0 (unique CALLINFO.BBS)
  107. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  108.    Genesis Deluxe 4.0 creates a file called CALLINFO.BBS which Global
  109.    War will read.  NOTE: THE CALLINFO.BBS FILE THAT GENESIS DELUXE
  110.    CREATES IS SIMILAR BUT DIFFERENT THAN THE MORE UNIVERSAL WILDCAT
  111.    FORMAT.  DO NOT CONFUSE THE TWO, THEY ARE NOT INTERCHANGABLE.  Use
  112.    the "/G" switch to tell Global War to look for CALLINFO.BBS.  The
  113.    calling convention is:
  114.  
  115.                 WAR /G d:\path\CALLINFO.BBS
  116.  
  117.    Your WAR.BAT should look something like this:
  118.  
  119.                 ECHO OFF
  120.                 CD \BBS\GLOBLWAR
  121.                 WAR /G C:\BBS\CALLINFO.BBS
  122.                 CD \BBS
  123.  
  124.    Substitute your actual subdirectory names if different.
  125.  
  126.    For Genesis Deluxe info & support, contact:
  127.           Prism Software, Box 267, Hannibal NY, 13074
  128.           Late Night BBS  (315) 592-7300 HST
  129.  
  130.  
  131. Global War for PC-Board (v14.x only, v12.x will not work) (PCBOARD.SYS)
  132. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  133.    PCBOARD creates a file called PCBOARD.SYS which Global War will read.
  134.    Use the "/P" switch to tell Global War to look for PCBOARD.SYS
  135.    Global War does not require PCBOARD.DAT.
  136.    The calling convention for the PC-BOARD version is:
  137.  
  138.                  WAR /P d:\path\PCBOARD.SYS
  139.  
  140.    Your WAR.BAT should look something like this:
  141.  
  142.                 ECHO OFF
  143.                 CD \BBS\GLOBLWAR
  144.                 WAR /P C:\BBS\PCBOARD.SYS
  145.                 CD \BBS
  146.  
  147.    Substitute your actual subdirectory names if different.
  148.  
  149.  
  150. Global War GAP, TAG, Telegard (or any system using DOOR.SYS)
  151. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  152.    DOOR.SYS is a standard door info file format used by many BBS
  153.    systems.  BBS authors: Help make life a LOT easier on us door
  154.    authors - consider supporting this standard!
  155.  
  156.    Use the "/D" switch to tell Global War to look for DOOR.SYS.
  157.    The calling convention is:
  158.  
  159.                 WAR /D d:\path\DOOR.SYS
  160.  
  161.    Your WAR.BAT should look something like this:
  162.  
  163.                 ECHO OFF
  164.                 CD \BBS\GLOBLWAR
  165.                 WAR /D C:\BBS\DOOR.SYS
  166.                 CD \BBS
  167.  
  168.    Substitute your actual subdirectory names if different.
  169.  
  170.  
  171. Global War for Spitfire (SFDOORS.SYS)
  172. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  173.    Spitfire creates a file called SFDOORS.DAT which
  174.    Global War will read.  Use the "/S" switch to tell Global War to
  175.    look for SFDOORS.DAT.  The calling convention is:
  176.  
  177.                 WAR /S d:\path\SFDOORS.DAT
  178.  
  179.    Your WAR.BAT should look something like this:
  180.  
  181.                 ECHO OFF
  182.                 CD \BBS\GLOBLWAR
  183.                 WAR /S C:\BBS\SFDOORS.DAT
  184.                 CD \BBS
  185.  
  186.    Substitute your actual subdirectory names if different.
  187.  
  188.  
  189. Global War for Searchlight BBS
  190. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  191.    For the Searchlight .DEF file, modify GAMES.DEF or DOORS.DEF
  192.    (whichever is chosen) as follows:
  193.  
  194.         0;0;0;10;Global War;.;WAR.BAT %B %T %N
  195.  
  196.         WAR.BAT should look something like this:
  197.  
  198.                 ECHO OFF
  199.                 CD \BBS\GLOBLWAR
  200.                 WAR /C %1 1 %2 %3 %4   <-the "1" assumes COM 1
  201.                 CD \BBS
  202.  
  203.    Substitute your actual subdirectory names if different.
  204.  
  205.  
  206. Global War for Maximus (DORINFOx.DEF, DOOR.SYS, CALLINFO.BBS)
  207. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  208.    Maximus can create DOOR.SYS, CALLINFO.BBS or DORINFOx.DEF.
  209.    DORINFOx.DEF is recommended since it supports multi-node
  210.    applications. Your MENUS.CTL file should have an entry something
  211.    like this if you are using DORINFOx.DEF.
  212.  
  213. NOTE: The CALLINFO.MEC file supplied with Maximus 2.01 and prior is not
  214. correct and will not work with Global War (or any other door most
  215. likely).  Use of Dorinfox.Def is recommended.
  216.  
  217.                 Display_File Misc\Dorinfo  Normal  "Global War"
  218.           NoDsp Xtern_DOS    WAR.BAT_%k    Normal  "G"
  219.  
  220.    WAR.BAT should look something like this:
  221.  
  222.                 ECHO OFF
  223.                 CD \BBS\GLOBLWAR
  224.                 WAR /R \BBS\DORINFO%1.DEF
  225.                 CD \BBS
  226.  
  227.    Substitute your actual subdirectory names if different.
  228.  
  229.  
  230. Global War, command line version
  231. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  232.    If your BBS can specify command line parameters (QuickBBS's menu 7
  233.    for example) you will use this.  The calling convention is:
  234.  
  235.            WAR /C BaudRate ComPort MinutesLeft FirstName LastName
  236.  
  237.    Edit WAR.BAT, which should look something like this:
  238.  
  239.                 ECHO OFF
  240.                 CD \BBS\GLOBLWAR
  241.                 WAR /C %1 1 %2 %3 %4 %5
  242.                 CD \BBS
  243.  
  244.    In this example (for QuickBBS), the BBS is passing the caller's
  245.    baudrate (%1), time remaining in minutes (%2), caller's first name
  246.    (%3) and last name (%4).  Include an extra parameter (%5) if you
  247.    anticipate having more than 2 word names (example: W. C. Fields).
  248.    The comm port (COM1) is hard coded in the batch file (1).  A baud
  249.    rate of 0 will cause Global War to run locally.
  250.  
  251.    Global War can be run locally from DOS using this method.
  252.    For example, typing...
  253.  
  254.                 WAR /C 0 1 60 FirstName LastName
  255.  
  256.    ...will let you try out the game in local mode from DOS.
  257.  
  258.  
  259. The Statusline
  260. ~~~~~~~~~~~~~~
  261.    The bottom line on your screen will display several important bits of
  262.    information.  For example:
  263.  
  264.    JOEL BERGEN | 23.14 | 08/05/92 17:24:27 | 122k | <flags>
  265.         1          2             3            4         5
  266.  
  267.    The information is:
  268.    1. The player's name exactly as it was passed to Global War from the BBS.
  269.    2. The amount of time the player has left in minutes.  The player
  270.       will receive a warning when he has less than 5 minutes left, and
  271.       the door will drop carrier & return to the BBS if he runs out of
  272.       time.
  273.    3. The current date and time.
  274.    4. The amount of free memory remaining.
  275.    5. The <flags> are:
  276.       Loc    : The door is operating in Local Mode - no communications I/O.
  277.       COMx   : The door is operating on Com1, Com2, Com3, or Com4 using
  278.                Global War's internal communications routines.
  279.       Fos    : A FOSSIL driver is being used for all comm I/O.  Absence
  280.                of this switch means the door's internal comm routines
  281.                are being used (See COMx)
  282.       GWTerm : The current player is using the GWTerm terminal program.
  283.                GWTerm in an optional terminal program your callers can
  284.                use to greatly speed up game play by displaying maps
  285.                instantly on their screen.
  286.       Mnode  : Multi-Node switch is set in WAR.CFG.  The door will lock
  287.                out games in use by the current node to prevent other
  288.                players on other nodes from playing in the same game at
  289.                the same time.
  290.       DV     : DESQview has been detected and the door is taking
  291.                advantage of it's features (giving up time slices, etc).
  292.       NF     : The /NOFLOW switch was used on the command line to tell
  293.                the door not to use hardware handshaking (CTS).  The door
  294.                will still use software handshaking (Xon/Xoff).
  295.       M      : Mouse driver has been detected and door is using the
  296.                mouse.
  297.  
  298. HST owners
  299. ~~~~~~~~~~
  300.    If you are running a US Robotics Courier HST using a locked baud rate
  301.    (19.2k/38.4k) insert the locked baudrate in WAR.CFG. The caller's
  302.    actual connection rate will be replaced by this value. It is also
  303.    recommended to set the non /ARQ connections buffer size to 128 bytes
  304.    by adding the "S15=8" setting in the initialization string or nRAM
  305.    configuration.
  306.  
  307. DESQview users
  308. ~~~~~~~~~~~~~~
  309.    Global War is DESQview aware.  You should see a "DV" on the
  310.    statusline which indicates that Global War has detected DESQview and
  311.    is giving up time slices and using DESQview's virtual screen address.
  312.    On a 286 or XT class machine, set "Writes Directly to Screen",
  313.    "Displays Graphics", and "Virtualize text/graphics" all to "N" and
  314.    Global War will multitask in a small window.
  315.  
  316. Multi-Node support
  317. ~~~~~~~~~~~~~~~~~~
  318.    Global War includes support for multi-node BBSs. Global War will
  319.    create temporary files named WARxx.LOK (where xx is a game number
  320.    1-255) to indicate that a game is in use by another node. To set up
  321.    Global War for multi-node use, you should do the following:
  322.  
  323.    In your AUTOEXEC.BAT, you should add:
  324.  
  325.        CD \BBS\GLOBLWAR  (or whatever your Global War subdirectory is)
  326.        DELETE *.LOK      (delete all LOK files)
  327.  
  328.    This is to make sure no stray WARxx.LOK files are lying around.
  329.  
  330.    If, for some reason, you need to create different WAR.CFG files for
  331.    each node, I recommend naming them WAR1.CFG, WAR2.CFG, etc.  Then, in
  332.    your WAR.BAT file, copy the appropriate WARx.CFG file to WAR.CFG.
  333.    For example: (sample WAR1.BAT for node 1, use a different batch file
  334.    for each node)
  335.  
  336.        CD \BBS\GLOBLWAR
  337.        COPY WAR1.CFG WAR.CFG   <- or WAR2.CFG for node 2, etc
  338.        WAR /P \BBS\PCBOARD.SYS
  339.        CD \BBS
  340.  
  341.    Alternately, you may use the /N command line switch to specify an
  342.    alternate WAR.CFG file.  For example:
  343.  
  344.        CD \BBS\GLOBLWAR
  345.        WAR /P \BBS\PCBOARD.SYS /N WAR1.CFG
  346.        CD \BBS                 ^^^^^^^^^^^--- specifies alternate WAR.CFG
  347.  
  348.    The /N must be specified LAST.
  349.  
  350. =-> Make sure the Multi-Node option is set to "Y" in WAR.CFG!
  351.  
  352. Files included or created by the game
  353. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  354.    WARxx.DAT    Data file containing info for each game (xx = game
  355.                 number) See DATAFILE.TXT for complete documentation.
  356.    WARxx.LOG    Data file containing the complete history of game xx.
  357.                 See LOGFILE.TXT for complete documentation.
  358.    WARxx.MSG    Messages sent from player to player in game xx. See
  359.                 MSGFILE.TXT for complete documentation.
  360.    WARxx.REC    Recovered game.  Created if a player loses carrier and
  361.                 is used to resume game where player left off if he calls
  362.                 back. See DATAFILE.TXT for complete documentation.
  363.    WARxx.LOK    For multi-node BBSs, this temporary zero-length file is
  364.                 used to lock out a game in use by another node.
  365.    WINNERS.WAR  Data file holds winner's names and number of games won.
  366.                 Sorted (and must remain sorted) in decending order of
  367.                 games won.
  368.    WINNERS.TOP  When the rankings are reset, WINNERS.WAR is saved as
  369.                 WINNERS.TOP and then WINNERS.WAR is deleted. (see
  370.                 war.cfg)
  371.    WONGAME.ANS  ANSI file that gets displayed when a player wins a game.
  372.                 Feel free to replace it with something snazzier if
  373.                 desired.
  374.    BEGIN.ANS    Warning displayed when a player chooses to begin a new
  375.                 game. May be edited to reflect your rules for beginning
  376.                 games.
  377.    BULLETIN.ANS You may create this file if you want to display some
  378.                 sort of bulletin to all players.  Displayed once when
  379.                 game entered. May be ANSI or ASCII.
  380.    AFRICA.ANS,  Maps used in the game.  May be edited slightly, but keep in
  381.    ASIA.ANS,etc mind that country names are displayed on top of these maps.
  382.    TEAM.DOC     Rules for Team play.
  383.    WAR.DOC      Rules for Normal games.
  384.    WAR.CFG      Configuration file.
  385.    WAR.EXE      The Global War game itself.
  386.    WAR.IMG      Data file of maps for Global War and GWTerm.  Color version.
  387.    WAR.MON      Mono version of WAR.IMG. Replace WAR.IMG with this if you
  388.                 are using a Hercules monochrome monitor.
  389.    TIMEON.WAR   Data file that keeps track of time used per day for each
  390.                 player.
  391.    DATAFILE.TXT Technical info on WARxx.DAT file format.
  392.    LOGFILE.TXT  Technical info on WARxx.LOG file format.
  393.    MSGFILE.TXT  Technical info on WARxx.MSG file format.
  394.    LOCKOUT.WAR  List of users to be prevented from joining games.
  395.  
  396. Other notes
  397. ~~~~~~~~~~~
  398.    Global War can use a fossil driver if you have one installed.  If
  399.    not, Global War will use its own built-in communication routines.
  400.    Use of a fossil driver (X00, BNU, etc) may be necessary if your PC is
  401.    not fully compatible, or if you are running some sort of multitasking
  402.    environment (DoubleDos, DESQview, Windows, etc) or if you have a high
  403.    speed modem (9600 baud or higher).  I recommend setting the "use
  404.    fossil if available" switch in WAR.CFG to "N" first, even if you have
  405.    a fossil driver loaded because Global War's internal comm routines
  406.    are better suited for game play.  If you experience any problems, set
  407.    it to "Y" and install a fossil driver.
  408.  
  409.    By default, Global War uses both Hardware handshaking (aka Flow
  410.    Control or CTS) and software (Xon/Xoff) handshaking.  You can disable
  411.    Hardware handshaking by specifying the /NOFLOW switch on the end of
  412.    the command line that calls Global War.  I haven't found it necessary
  413.    yet, but if the door freezes up your computer it's worth a try.
  414.    DON'T use this if you are using a High Speed modem (9600+ bps)
  415.  
  416.    If you would like to make some sort of announcement to all GW
  417.    players, such as a Hall of Fame list, you can create a file called
  418.    BULLETIN.ANS and place it in your Global War directory.  GW will
  419.    output this file after displaying the copyright notice. BULLETIN.ANS
  420.    may be an ANSI file or a plain ASCII file. Similarly, the file
  421.    WONGAME.ANS is displayed when a player wins a game and may be edited.
  422.  
  423.    Global War relies heavily on your hardware time clock.  If your time
  424.    clock is not working reliably or is nonexistant, get it fixed!
  425.    Fixing it usually means simply replacing 4 AA batteries inside your
  426.    PC. If you start getting "Timeclock or Game Corrupted" error
  427.    messages, it's too late.
  428.  
  429.    All *.TXT files included in this archive are for your information only
  430.    and are not required by the game.  The rest of the files ARE required.
  431.  
  432.    If you can't get Global War to work with your system, feel free to
  433.    contact me at ProVision.  Together, we'll make it happen!
  434.  
  435.    GLOBAL WAR requires no maintenance or Sysop intervention.  Set it up
  436.    once and forget about it.  Completed games are automatically deleted
  437.    after a specific number of days (see WAR.CFG).  Even games that have
  438.    been "forgotten" will automatically be deleted.  If you change the
  439.    name of a user on your BBS who is involved in the game, you will have
  440.    to edit the WARxx.DAT files (where xx is the game number) to reflect
  441.    this change, or the game will not recognize this "new" player. Change
  442.    their name in WINNERS.WAR if they've won any games too.  Player's
  443.    names are not case sensitive.  I suggest using an editor such as
  444.    Qedit or DOS 5's editor. Don't use a word processor.  Many word
  445.    processors insert weird control codes that will give GW fits. Type
  446.    over the old data, DON'T delete or add any lines or GW will surely
  447.    crash with a runtime error.
  448.  
  449.    Known bugs:  PC-Board Sysops, you will need to lower your online time
  450.    to under 9 hours per call (32767 seconds). If you don't, your time
  451.    remaining stored in PCBOARD.SYS will wrap around and go negative, and
  452.    you won't be able to get into Global War.
  453.  
  454.    Give my board, ProVision BBS, a call for the latest version of Global
  455.    War and additional support software and documentation.  The phone
  456.    number is (206) 353-6966 or (206) 353-2494.  Or you may contact me by
  457.    sending netmail to Joel Bergen at Fidonet node 1:343/65.
  458.  
  459.    I hope that you and your callers enjoy Global War, and that you find
  460.    it worthy of your support.  Please read the file REGISTER.TXT for
  461.    information on how to register your copy of Global War.
  462.  
  463.                                 Joel Bergen
  464.