home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / BORG14TW.ZIP / BORG.DOC next >
Text File  |  1994-12-29  |  16KB  |  343 lines
  1. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  2. THE BORG - (C) Copyright 1994, SimSoft Professional Computer Services.
  3. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  4.  
  5.                                 Version 1.4
  6.  
  7. WE HAVE TESTED THIS ADD-ON REPEATEDLY WITH TRADEWARS VERSION 2 BETA 5 AND
  8. HONESTLY BELIEVE THAT ALL BUGS HAVE BEEN HAMMERED OUT.  PLEASE REPORT ANY
  9. UNDISCOVERED BUGS TO SIMSOFT PCS AT THE ADDRESS OR PHONE NUMBER LISTED
  10. BELOW.
  11.  
  12. If there is an option that you believe would enhance the BORG, please let us
  13. know.  We are always looking for ways to improve our products for our users!
  14.  
  15. THANX!
  16.  
  17. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  18.                                   Disclaimer
  19.  
  20. Neither David R. Sim, nor SimSoft Professional Computer Services, nor any
  21. person or entity affiliated with either, will assume any responsibility for
  22. any situation which occurs as a result, be it direct, or indirect, of the
  23. use of this program.  THE USER ASSUMES ALL RISK WHICH MAY BE ASSOCIATED WITH
  24. THE USE OF THIS PROGRAM.
  25.  
  26. There are no warrantees whatsoever, expressed or implied, as to the
  27. usefulness or effectiveness of this system for any particular purpose.
  28. This software is sold as is, and is not guaranteed to work on any particular
  29. machine, or under any particular hardware or software configuration.
  30.  
  31. This program has been tested on our hardware under numerous configurations
  32. to perform as described in this documentation.
  33.  
  34. USE OF THIS SOFTWARE IN ANY WAY CONSTITUTES IMMEDIATE ACCEPTANCE OF THESE
  35. TERMS BY THE USER.
  36.  
  37. Reverse Engineering Notice
  38.  
  39. You MAY NOT disassemble, reverse engineer, hack, change, modify, alter,
  40. mutate, refashion, vary, or catalyze this program or its documentation in
  41. any way, manner shape or form.
  42.  
  43. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  44.  
  45.                             Shareware registration
  46.  
  47. The BORG is a commercial software product, distributed via Shareware.
  48. If you like it and are keeping a copy for your personal or BBS use, please
  49. send a $7.00 registration fee + $3 S/H to the address below. By doing so you
  50. will receive the following benefits:
  51.  
  52.       1.  Registered Key that will enable all features of the BORG.
  53.       2.  Support for the program by mail or phone.
  54.       3.  A FREE copy of the CRYSTALINE ENTITY add-on!!
  55.  
  56. Whether you register or not, we encourage you to make copies of THE BORG
  57. for any friends, acquaintances and associates you feel may enjoy the program
  58. if the executable, this document, and all other distribution files have not
  59. been modified in any way.
  60.  
  61. If you have a modem, please feel free to upload THE BORG to your favorite
  62. BBS. They will appreciate it and so will we. Please include all files on any
  63. copies you make. This will help ensure that future users of THE BORG will
  64. get maximum enjoyment from our product.
  65.  
  66.                     Please send your $7.00 registration to:
  67.               (please include $3 S/H to help defray mailing costs)
  68.  
  69.                                   TW-EXTENDERS
  70.                      SimSoft Professional Computer Services
  71.                              610 Highlands Road, #7
  72.                                Franklin, NC 28734
  73.                                  (704) 524-9348
  74.  
  75. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  76.  
  77. THE BORG is one of the many add-ons available for TradeWars 2002 version 2
  78. from SimSoft Professional Computer Services.  We have paid very close
  79. attention to detail in an attempt to make the BORG appear to be an actual
  80. part of the TradeWars game, even down to the colors of the messages that are
  81. sent to traders when the BORG encounters them.  If you notice something that
  82. you believe could make the BORG appear even more as part of the actual game,
  83. please drop us a not or give us a call.
  84.  
  85. When the BORG is run the first time, it will create an extremely powerful
  86. alien in record number 50 of the ALIENS.DAT database named LOCUTUS Of BORG.
  87. This BORG will then be sent through a specified number of sectors of the
  88. TradeWars 2002 universe in a similar way that a trader passes from sector
  89. to sector.  As it enters each sector, it will scan for fighters, armid mines
  90. and traders, in that order.
  91.  
  92. Upon finding a traders deployed fighters (it will not mess with Ferrengi or
  93. Rogue fighters), it will send two messages to the trader via the traders
  94. deployed fighters in the same manner as TradeWars does.  The first being
  95. "Locutus of BORG has entered the sector", and the second being "Locutus of
  96. Borg is attacking!".  It will then "assimilate" as many of them as it can,
  97. up to the maximum number of fighters that TradeWars will allow it to carry
  98. (30,000).  If there are any fighters remaining after assimilation, they will
  99. be destroyed.
  100.  
  101. It will then destroy all type 1 armid mines belonging to any traders (it will
  102. not mess with ferrengi or rogue mines) that are in the sector and send a
  103. message to the trader that all of the mines were destroyed by the BORG.
  104.  
  105. When the BORG runs across a trader, it will create another BORG in the next
  106. decending record available with the identical name and characteristics of the
  107. trader and his ship. It will then destroy that traders ship, and kick that
  108. trader out of the game for the number of days that the sysop has defined in
  109. TEDIT (the death delay).  It will continue to add additional BORG aliens
  110. until a maximum of ten have been created.  At that point, the BORG will
  111. merely destroy the trader's ship and knock him out for the death delay days.
  112.  
  113. The BORG that are created when a trader is "assimilated" do not actually do
  114. anything when the BORG program is run.  They are merely there for vengeful
  115. traders to hunt down and destroy.  There is, however, an option that is
  116. available in the registered version called RECURSE.  When this option is
  117. enabled, EVERY BORG in the database will individually take their turn hopping
  118. from sector to sector doing the same as LOCUTUS.  Use of this feature can
  119. create alot of frustration among players.  If you have a 1000 sector
  120. universe with 10 BORG cruising through say, 10 sectors each and assimilating
  121. everything in their path, then these BORG will cover more of the universe in
  122. one night than your average player can cover in a couple of days.  Use the
  123. RECURSE option as you see fit.
  124.  
  125. NOTE:
  126. The first time BORG.EXE is run, a file will be created in the directory
  127. which contains BORG.EXE called BORG.INS, and a message will be posted to all
  128. traders that the BORG have been unleashed in the TradeWars universe.  It is
  129. a small file, and simply contains the date that the BORG was installed in
  130. the tradewars game.  This file must be present after this run. If it is not,
  131. the program will continually post the above message to the traders every time
  132. that it is run.  BORG /REMOVE will delete this file, and post a second
  133. message to the traders that the BORG have been removed.
  134.  
  135. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  136.  
  137. To run the BORG add-on, you can place it in the TW2002 directory and just
  138. type:  BORG and press ENTER.  It is best run however, just after the Trade
  139. Wars maintenance program EXTERN.EXE.  You should place it in your nightly
  140. maintenance batch file so it is called directly after EXTERN.EXE.
  141.  
  142. Another option is to place the BORG.EXE program in a different directory if
  143. you do not like to mix your different programs in the same directory.  If
  144. this is the case, you will need to add the /DP command line parameter so that
  145. the BORG program can find the TradeWars data files.
  146.  
  147. Example: BORG /DP:C:\DOORS\TW2002
  148.  
  149. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  150.  
  151. There are several command lines parameters that are available to modify the
  152. way the BORG acts.  Most of these however, are only available in the
  153. registered version.  The command line parameters are listed below, with the
  154. registered features marked with an asterisk.
  155.  
  156. Optional command line parameters:
  157.  
  158.   /DP:xxx  Allows you to set the path to the TradeWars data files.
  159.  
  160.            The following example would run the BORG, telling it to look for
  161.            the TradeWars data files in the C:\DOORS\TW2002 directory.
  162.  
  163.            Example: BORG /DP:C:\DOORS\TW2002
  164.  
  165. * /ST:xxx  Allows you to set the number of sectors that the BORG will travel
  166.            through.  Range = 1 - 255, Default = 5.
  167.  
  168.            The following example would run the BORG, telling it that you
  169.            want the BORG to travel through 20 sectors instead of the default
  170.            5.
  171.  
  172.            Example: BORG /ST:20
  173.  
  174. * /DAY:xx  Specifies the Day to actually run.  1=Sunday, 2=Monday, 3=Tuesday,
  175.            4=Wednesday, 5=Thursday, 6=Friday, 7=Saturday, R=Random.  The day
  176.            numbers can be in any order and in any combination.  If R is
  177.            specified, the day numbers will be ignored.  You could have the
  178.            BORG run through the universe every day of the week if you wanted.
  179.            The Unregistered version will only move on Fridays.
  180.  
  181.            The following example would run the BORG, telling it to move
  182.            randomly. ie. the program will pick a number between 0 and 1. If
  183.            it chooses 1, the BORG will run.  If it chooses 0, it will not.
  184.  
  185.            Example: BORG /DAY:R
  186.  
  187.            The following example would run the BORG, telling it to only move
  188.            through sectors on Tuesday, Wednesday, and Thursday.
  189.  
  190.            Example: BORG /DAY:345
  191.  
  192. * /CP:xxx  Specifies the odds that the BORG will be able to find and
  193.            assimilate traders when they are cloaked. Range = 1 - 100,
  194.            default = 50% chance.
  195.  
  196.            The following example would run the BORG, telling it that it has
  197.            a 75 percent chance of finding and assimilating a trader when he
  198.            is cloaked.
  199.  
  200.            Example: BORG /CP:75
  201.  
  202. * /NOFED   Tells the BORG to stay out of fedspace, stardock and class 0 ports.
  203.  
  204.            The following example would run the BORG, telling it that you
  205.            do not want it to enter sectors 1 - 10, the stardock sector, or
  206.            either of the 2 class 0 port sectors.
  207.  
  208.            Example: BORG /NOFED
  209.  
  210. * /NF      No Fighters.  Tells the program to leave fighters alone when found.
  211.  
  212.            The following example would run the BORG, telling it that you
  213.            do not want the BORG to destroy any fighters, no matter who they
  214.            belong to.
  215.  
  216.            Example: BORG /NF
  217.  
  218. * /NM      No Mines.  Tells the program to leave mines alone when found.
  219.  
  220.            The following example would run the BORG, telling it that you
  221.            do not want it to destroy any mines, no matter who they belong to.
  222.            Example: BORG /NM
  223.  
  224. * /FP:xxx  Percentage of fighters to assimilate or destroy.  Range = 1 - 100.
  225.            Default = 50.  Overrides the /NF parameter.
  226.  
  227.            The following example would run the BORG, telling it that you
  228.            want the BORG to only destroy 25% of the fighters in any given
  229.            sector.
  230.  
  231.            Example: BORG /FP:25
  232.  
  233. * /MP:xxx  Percentage of type 1 armid mines to destroy.  Range = 1 - 100.
  234.            Default = 50.  Overrides the /NM parameter.
  235.  
  236.            The following example would run the BORG, telling it that you
  237.            want the BORG to only destroy 25% of the armid mines in any given
  238.            sector.
  239.  
  240.            Example: BORG /MP:25
  241.  
  242. * /MF:xxx  Minimum deployed fighters required to fend off an assimilation.
  243.            Range = 1 - 32,000, Default = 32,000.
  244.  
  245.            The following example would run the BORG, telling it that you
  246.            do not want the borg to destroy any fighters in the current
  247.            sector if the number of fighters in that sector are greater than
  248.            or equal to 2000.
  249.  
  250.            Example: BORG /MF:2000
  251.  
  252. * /MM:xxx  Minimum deployed mines required to fend off an assimilation.
  253.            Range = 1 - 250, Default = 250.
  254.  
  255.            The following example would run the BORG, telling it that you
  256.            do not want the borg to destroy any mines in the current sector
  257.            if the number of mines in that sector are greater than or equal
  258.            to 100.
  259.  
  260.            Example: BORG /MM:100
  261.  
  262. * /NS      Tells the program NOT to destroy the traders ship.
  263.  
  264.            The following example would run the BORG, telling it that you
  265.            do not want it to destroy any ships that it runs across.
  266.  
  267.            Example: BORG /NS
  268.  
  269. * /NK      Tells the program NOT to knock trader out of the game for xx days.
  270.  
  271.            The following example would run the BORG, telling it that you
  272.            do not want it to knock any players out of the game for the
  273.            Sysop configured "Death Delay" number of days.
  274.  
  275.            Example: BORG /NK
  276.  
  277. * /ALL     Allows each BORG in database to perform the assimilation cycle.
  278.            By default, only LOCUTUS will actually assimilate anything.
  279.  
  280.            The following example would run the BORG, telling it that you
  281.            want EACH of the BORG aliens to travel through the designated
  282.            number of sectors, each assimilating and destroying things as they
  283.            move along.
  284.  
  285.            Example: BORG /ALL
  286.  
  287.   /LOG     Causes all BORG actions to be written to a log file.
  288.  
  289.            The following example would run the BORG, telling it that you
  290.            want it to write everything that it does to the log file
  291.            BORG.LOG.
  292.  
  293.            Example: BORG /LOG
  294.  
  295. * /LOC     Displays the sector location of all BORG aliens.
  296.  
  297.            The following example would run the BORG, telling it that you
  298.            want it to display the sector locations of all BORG aliens in the
  299.            database, then terminate.
  300.  
  301.            Example: BORG /LOC
  302.  
  303. * /REMOVE  Removes all BORG from the Alien database.
  304.  
  305.            The following example would run the BORG, telling it that you
  306.            want it to remove all BORG aliens from the alien database.  If
  307.            the BORG is run after this is done, it will add a BORG back to the
  308.            database.
  309.  
  310.            Example: BORG /REMOVE
  311.  
  312.   /@xxxxx  Tells the BORG to look for all other command line options in the
  313.            file xxxxx.
  314.  
  315.            The following example would run the BORG, telling it that all
  316.            command line options are in the file BORG.PAR.
  317.  
  318.            Example: BORG /@BORG.PAR
  319.  
  320.            The format for the parameter file is simple.  Just place each
  321.            command line option on a separate line.  See the file SAMPLE.PAR
  322.            for an example.
  323.  
  324. Most parameters can be used in cunjunction with another.  Some do however,
  325. override others, such as /NF (no fighter destruction) will be ignored when
  326. used along with /FP:xxx (percent of fighters to destroy).  Also note that
  327. some parameters such as /LOC and /REMOVE terminate the program after doing
  328. their thing, rather than sending the BORG on thier journey.
  329.  
  330. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  331.  
  332.                                UPGRADING NOTES:
  333.  
  334. Any updates to this program may be copied directly over the current version.
  335.  
  336. We do recommend, however, that you run BORG /REMOVE with the old version,
  337. before running the new version.  The new version will add him back into the
  338. game the first time that it is run.
  339.  
  340. -=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  341.  
  342. .end of documentation.
  343.