home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / games / tw2_100.zip / SYSOP.DOC < prev    next >
Text File  |  1989-12-08  |  35KB  |  846 lines

  1.  
  2.  
  3. SysOp DOCUMENTATION for Tradewars Release 10_00_TW   Released 12/17 1989
  4. Tradewars by Chris Sherrick (c) 1986
  5. Release 4.0(and greater) Copyright 1986, 1987, 1988, 1989 by:
  6.               Co-Author, John Morris                   
  7.               All Rights Reserved
  8.  
  9.  
  10.  
  11.  
  12.                               *
  13.           ********************
  14.         **********************    *                   *
  15.         *********************   **                  **
  16.        *         *****         ***                 ***
  17.                  *****       *****               ***** 
  18.                  *****       *****               *****
  19.                  *****        *****             *****    
  20.                  *****        *****      *      *****
  21.                  *****         *****    ***    *****       
  22.                  *****          *****  *****  *****     
  23.                  ***             *****************   
  24.                  **               ******   ******   
  25.                 *   RADE           ****     ****           
  26.                                    **       **         
  27.                                   *        *   ARS  
  28.                                                 
  29.                                        
  30.                                             
  31.                                        
  32.  
  33. Copyright & License Info
  34. ------------------------
  35.  
  36.   TradeWars is Copyrighted by Chris Sherrick and I (John Morris). This 
  37. means that we are the -owners- of TradeWars. This means that our rights
  38. to the program are protected under National Law, and International
  39. Treaty!
  40.  
  41.   Most people shouldn't be concerned with all of that. But there are a
  42. few who insist on tweaking our old code aorund and putting their own
  43. name on it.  That practice is Unlawful, Unethical, and just plain theft.
  44.  
  45.   All users of TradeWars are granted a limited license to use, copy and
  46. distribute TradeWars any way they see fit as long as a few rules are
  47. obeyed:
  48.  
  49. 1.  You may use the program for any commercial, or non-commercial purpose.
  50.    Use it on your company, private or school BBS, or just about anything
  51.    else, I leave it up to your imagination.
  52.  
  53. 2.  You may copy and distribute as many copies of this program as you like,
  54.    as long as you don't charge money for the program itself.  A small fee
  55.    is allowed (for copying, handling, mailing, and the diskette carrying
  56.    the copy) is allowed, BUT this amount is not to exceed the real costs.
  57.    (in other words, you may NOT make a profit!)
  58.  
  59. 3.  The program is used, and/or distributed unmodified, wih complete
  60.    documentation.
  61.  
  62.  
  63. Warranty
  64. --------
  65.  
  66.   Warranty?? Are you nuts?  There is no warranty of ANY kind given on
  67. the operation of TradeWars! This program is provided AS IS!
  68.  
  69.  
  70.  
  71.  
  72. ** READ THESE DOCS .. who knows there may be something important in here!
  73. ** ALSO check appendix A for some current TW2 gossip!
  74. ** SEE appendix B for info on how to interface to TradeWars 10.0
  75.  
  76. Welcome to the world of Tradewars ][! And thank you for using an Authorized
  77. release of Tradewars!   Speaking of Tradewars, There are a bunch of 
  78. Tradewars clones which go by various names, and some which are distributed
  79. under the name of Tradewars! . There is only ONE Tradewars Version 2.
  80. There is NO such thing as Tradewars 500, or Tradewars 1000, or TW1K or
  81. whatever. There is only Tradewars Version 2.
  82.  
  83. Because of the size of the files needed for Tradewars to run, they are
  84. distributed in three ZIP files:
  85.  
  86. TW100EXE.ZIP - contains Tradewars Executable files & documentation.
  87.  
  88.  
  89.  
  90. TW100EXE.ZIP contains the following files:
  91. ------------------------------------------
  92. SYSOP   .DOC - This file
  93. TW2     .EXE - TW main executable file
  94. TWINSTR .DOC - Tradewars player instructions
  95. TWOPENC .DAT - ANSI graphics opening screen
  96. TWOPENA .DAT - TEXT opening screen
  97. TWEDIT  .EXE - TWEDIT executable file
  98. TWEDITOR.DOC - Tradewars Editor SysOp documentation.
  99. TWRI    .EXE - Pseudo random init program
  100. PORTINIT.TW2 - Port info used by TWRI
  101. TEMPLATE.TW2 - Template of map used by TW2
  102.  
  103. *******************************************************************
  104.  
  105. **The following is a list of files used by TW2 at run-time:
  106. -----------------------------------------------------------
  107. (These files MUST exist on the same drive/path as TW2)
  108.  
  109. Program files:
  110. TW2     .EXE - Plays Trade Wars. 
  111. TWEDIT  .EXE - The Trade Wars Editor.
  112. TWMAINT .EXE - TW2 Maintenance program
  113. TWRI    .EXE - TradeWars Random Initialization program for Trade Wars Ver. 2.
  114.                Sets up the following data files.
  115.  
  116. Data files:
  117. TWMAIN  .DAT - Main game options for Trade Wars Ver. 2.
  118. TWPLAYER.DAT - Contains current player info.
  119. TWSCTR01.DAT - Contains sector warp info.
  120. TWSCTR02.DAT - Contains info on what each sector contains.
  121. TWPORT  .DAT - Contains info for each port.
  122. TWPLANET.DAT - Contains info on each planet.
  123. TWTEAM  .DAT - Contains Team Info.
  124. TWNEWS  .DAT - Contains Galactic Newspaper and Sysop messages.
  125. TWPMESS .DAT - Contains info on messages to players.
  126. TWRMESS .IDX - Contains radio message index info.
  127. TWRMESS .DAT - Radio message data file.
  128.  
  129. Text files:
  130. SYSOP   .DOC - This file.
  131. TWEDITOR.DOC - Documentation for TWEDIT.EXE (the editor.)
  132. TWINSTR .DOC - The instructions for TW2.EXE (the game.)  This file is
  133.                used by TW2.  I also recommend putting this up for download
  134.                by the players.
  135. TWOPENA .DAT - The opening message.  You can change this to what ever
  136.                you want, but make sure it exists.
  137. TWOPENC .DAT - ANSI graphics opening message.
  138. TWCLOSEA.DAT - Tradewars closing message.
  139. TWCLOSEC.DAT - ANSI graphics closing message.
  140.  
  141. [*END of file listing*]
  142.  
  143. ********************************************************************
  144.  
  145.  Features of this release of TW2  
  146.  (or.. if you will, Features of the DoorMerge Include files)
  147.  -----------------------------------------------------------
  148.  
  149.  [SysOp Functions]
  150.  
  151.  Function keys are active in TW2:
  152.  
  153. F1  --  Exit TW2 immediately
  154.  
  155. F2  --  This key will cause TW2 to load a copy of COMMAND.COM over itself
  156.         type EXIT to return to TW2. NOTE: COMMAND.COM must be present in
  157.         the same path as TW2
  158.  
  159. F7  --  Toggle Music on/off
  160.  
  161. F8  --  By pressing F8 you can adjust a users time allotment in that game.
  162.         It will not adjust the users time as far as the monitor is
  163.         concerned. You can force the user off-line in this manner by
  164.         adjusting his time down to a small amount.
  165.         A prompt will come up asking you the amount of time you wish the
  166.         user to have.  This prompt tells you the current amount of time
  167.         left.  If you change the time, the user will get a warning
  168.         notice, whether the time limit is less, or more.
  169.  
  170. F9  --  By pressing F9 you will change the current state of 'SNOOP' (local
  171.         display). This operates in the same manner as SNOOP in RBBS-PC, but
  172.         will not change the status of SNOOP of the BBS (if any). 
  173.  
  174. F10  -  By pressing F10 you will engage CHAT mode with the user. Just hit
  175.         ESC to get back to the game.
  176.  
  177. /B   -  This tells TWMaint.EXE to run in 'Maintenance Only Mode'.. TWMaint
  178.         will run in two modes. If you choose not to do external maintenance,
  179.         TW2.EXE will do maintenance by RUNning TWMaint, and TWMaint will
  180.         in turn run TW2 when it is done.  If you do maintenance externally
  181.         put the /B after TWMAINT to let it know your are running it during 
  182.         and event period.
  183.  
  184. /C   -  Tells TW which com port to use. Example:  /C1 for COM1. Normally
  185.         this is NOT USED!
  186.  
  187. /D   -  Use DOS only for input and output. This will hopefully facilitate
  188.         redirection (if nothing else works).
  189.  
  190. /F   -  Force Fossil driver to be used. Tradewars normally searches to see
  191.         whether or not there is a Fossil driver. If it finds one it tries 
  192.         to use it. If it can't init the Fossil driver, then it will switch  
  193.         to its normal comm routines.
  194.  
  195. /G   -  command line switch. This will force Ansi color on.
  196.         (For OPUS sysops only)
  197.  
  198. /L   -  This release includes a special command line switch
  199.         /L    This will put the programs in 'local only' mode, and NO 
  200.         BBS files of ANY kind need to be present. 
  201.  
  202. /P:  -  Use this one to specify the special info file TW2 will be looking 
  203.         for. (See your special BBS docs below)
  204.  
  205. /S   -  This one will tell TW that you have a special speed for the modem
  206.         to operate at. and example:  /S19200  or  /S38400   This is normally
  207.         NOT USED!
  208.  
  209. /Txx -  This command line switch is also for OPUS sysops. This will tell
  210.         exactly how long the user is allowed on the BBS for this call.
  211.         Example:  /T45   for 45 minutes allowed from the time user logs on to 
  212.                          the BBS
  213.  
  214. /Z   - Use DOS for all screen writes.  TW normally uses DOS for all local
  215.        Screen writes except for 'Line 25'.  This will force line 25 to be
  216.        printed using DOS.  (NOTE: This does cause some wierd things to appear
  217.        locally, but the remote user won't notice.)
  218.  
  219.  [Other Features]
  220.  
  221. 1. Commands can be stacked. They work in a slightly different manner
  222.    than RBBS-PC stacked commands, and are extemely useful.
  223.  
  224.    For instance in Tradewars 2, Instead of typing:
  225.  
  226.    M [enter] (move)
  227.    wait for prompt....
  228.    174 [enter] (move to sector 174)
  229.    wait for prompt....
  230.    M [enter] (move)
  231.    wait for prompt....
  232.    176 [enter] (move to sector 176)
  233.  
  234.    A user just needs to type:
  235.  
  236.    M;174;M;176   or....
  237.    M 174 M 176   or...
  238.    M,174:M 176   etc.  
  239.  
  240.    stack chars are:  ' ' ',' ';' & ':'
  241.  
  242.    at the first prompt, and the game will take care of the rest.
  243.  
  244. 3. Another Feature in Tradewars for the SysOp is the 'E' function.
  245.    Only the SysOp (either remote/local) has access to this function,
  246.    No one else has access to it.  The 'E' function allows the SysOp to
  247.    run the Tradewars 2 Editor from Tradewars.  From the Editor enter
  248.    'T' to return to Tradewars 2, or if in Local Mode, you can enter 'X'
  249.    to eXit to dos, Also the 'Q' command will return you to the monitor.
  250.  
  251.  
  252. [*END of Other Features*]
  253.  
  254. VERSION INFO -- (All version below 10.0 have condensed history info)
  255. ********************************************************************
  256.  
  257. Features of TW2 release 5.x (5.0 released on 5/01 to 5.24 rel. on 06/19/88)
  258.  
  259.   Several parts of the game have been completely (and I mean completely)
  260. rewritten to run more logically, and reduce the risks of bugs. Cabal
  261. maintenance was one of the areas that went through this. The Cabal are now
  262. more ruthless that ever before, and to keep things interesting all 20
  263. Cabal groups are active at least as long as the maintenance program is
  264. running. Some groups won't survive the maintenance program, but they are
  265. active while it is running.
  266.   Cabal Regeneration now means what it says, so be careful how high you
  267. set the regeneration per day. Before, there was 'sort of' a limit on
  268. how many total Cabal were wandering around in the galaxy.. This is no
  269. longer so.
  270.  
  271. Features of TW2 Release 6.1  (10/23/88)
  272. ---------------------------
  273.  
  274.   The Cabal are now totally configurable. you can set the amount of groups
  275. (up to 50).  The Cabal are still VERY ruthless in the game, and it really
  276. takes a good player, or good team to make it up high in the rankings.
  277.   You can set the Cabal difficulty ratio, which you'll find in the
  278. [G]eneral edit area of TWEDIT.  This level can be from 1 to 10, and
  279. a good setting is 3 or 4..
  280.   You can also set the sectors the Cabal can reside in!  no more 83-85
  281. restriction! This really makes the game interesting. There are 8 Cabal
  282. sectors in all.
  283.  
  284. Release 6.2  (01/08/89)
  285. -----------------------
  286.  
  287.   Most important feature added in 6.2 is true record & file locking using
  288. DOS's SHARE.  If you specify Network in the TW2.DAT file, SHARE must be
  289. loaded in every partition you plan to run TW in!  Along with the file 
  290. locking a couple real time mods were added.  When you are playing the game
  291. and run into another 'actively playing user' you will see a '*' in front
  292. of their name!  The game also checks to see if the user has been attacked
  293. by an active player, and will kick 'em out if they were killed!
  294.  
  295. Release 6.3  (04/09/89)
  296. ------------------------
  297.  
  298. Added more ANSI graphics with the addition of a third 'graphics mode'. The
  299. first mode is plain text, second mode is ANSI colored text, and third is
  300. ANSI color/graphics.  Only the higher speed modem users will want to use
  301. this mode (unless they are suckers for punishment). Also cleared up are a
  302. few ambiguities and/or irregularities.  Added is an appendix explaining 
  303. how you can interface to TW from your BBS system (if it does not already
  304. have an interface built in.)
  305.  
  306. Release 6.31  (05/30/89)
  307. ------------------------
  308.  
  309. Some minor bug fixes to 6.30.. but still, as it turns out, on the buggy
  310. side.
  311.  
  312. Releases 7.x 8.x 9.x (4/01/89 to 7/01/89)
  313. -----------------------------------------
  314. Internal ONLY releases of the new TW in C.. These versions led to:
  315.  
  316. Release 10.0 (12/17/89)  (First used by my TW players 7/10/89 or so)
  317. -----------------------
  318.  
  319. First release of TradeWars in the C language.  Some former 'features' were
  320. nuked in favor of new techniques to be used in the future. For instance,
  321. graphics are gone until a suitable method (in other words: a FAST method)
  322. is completed. Added is support for more BBS types, Dynamic Cabal (they can
  323. move *while* the user is on-line), and internal support for a wide variety
  324. of future options. The game is much faster in many areas.. and about the
  325. same in others. The EXE file is currently 60K smaller than the last BASIC
  326. version (and 40K in the current EXE file is support for a wide variety of
  327. communication options including FOSSIL, Non/FOSSIL support w/ BPS rates of
  328. up to 57600). (so, I'm thinking ahead..)  Also, The C version is uncrashable
  329. when you think in terms of 'Hit any key to return to system' seen when a 
  330. BASIC program encounters something it doesn't like. Any possible error 
  331. should result in a graceful exit.
  332.  
  333. Getting started with TW2
  334. ------------------------
  335.  
  336. Notes TW2 by Chris Sherrick:
  337. ----------------------------
  338.  
  339.      I recommend using this game with a cache program.  Since this game
  340. was designed to survive if people hung up on it, it makes frequent use of
  341. the disks.  You will save your disk some usage if you're using a cache.
  342.  
  343.      You should make changes in the program, I ask that you don't change
  344. any of the program files when you distribute them.  Make it into another
  345. file and distribute it along with the program, but I ask that you keep
  346. the original programs intact.  This program is copyrighted.
  347.  
  348.      The reason I wrote this program is because I always wanted to play
  349. a good multi-player strategy game.  I'm too poor to afford a subscription
  350. to something on a national level (like Compuserve) so I never got to play
  351. those games.  One day I decided that since no one had a good multi-player,
  352. I'd write one.  Unfortunately I don't get to play the game (since I run
  353. it and I usually get accused of cheating - I'm a good player! - Someone
  354. please write another multi-player game so I can play it!)
  355.  
  356.      Now for the begging.  This game is distributed as "Shareware."  My
  357. attitude is that I'd rather have people having a good time playing the
  358. game than for me to get rich; but if you could, please send $35.00 to the
  359. address below:
  360.  
  361. TW2
  362. c/o Chris Sherrick
  363. 1515 Ridgeland Dr.
  364. Sparks, NV  89431
  365.  
  366. If I get something, I'll try to write back, but I can't guarantee anything;
  367. I'm a busy college student.
  368.  
  369.      That's all I have to say in this letter.  I hope you fully enjoy
  370. Trade Wars to you fullest.  The only problem with it is people tend to
  371. spend their time playing TW2 and not posting, but oh well, you can't have
  372. it all.
  373.  
  374. P.S.  Call The Reno RBBS - Sysop John Morris / 702-746-1364 DATA
  375.                                                702-746-1365 DATA
  376.                                                702-746-1358 VOICE
  377.  
  378.      This BBS and sysop has been very helpful to me in play testing and
  379. modifying this version.  If it wasn't for John Morris, this game wouldn't
  380. be available for any BBS.  Also, he has the latest and newest releases of 
  381. this program.
  382.  
  383. [Getting started]
  384. -----------------
  385.  
  386. First unpack the TW2 .ZIP files using PKZIP 1.01(or greater). Copy these 
  387. files to your drive/path where you wish to put the game. For first time 
  388. users, run TWRI.EXE to initialize the game. This will create a sector galaxy,
  389. and several other files.
  390.  If you are using a monitor pgm, add TW2 to your GAMES.DOR file, along with
  391. a desription (anything you like). Then just run the game from the monitor,
  392. like any other Door game.
  393.  If you aren't using the door monitor, add the name TWARS2 to your MENU5
  394. file, and create a batch file called TWARS2.BAT.  The contents of the 
  395. batch file are as follows (assuming you are using the pgm WATCHDOG):
  396.  
  397. WATCHDGx OFF       (or whatever WATCHDG program you are using)
  398. TW2.EXE %1         (%1 signifies the node in use, it is passed on by RBBS
  399.             NOTE:* if you run a single node, do not add the %1 after TW2.EXE)
  400.  
  401. and thats it.
  402.  
  403. ** NOTE! ** WATCHDOG (or any carrier monitor program MUST NOT be loaded or
  404. active when running TW2! TW2 does its own carrier monitoring.)
  405.  
  406. Now a user just needs to enter TWARS2 when asked for the door, and they
  407. are beamed over to the Tradewars galaxy.
  408.  
  409.  
  410.  
  411. Getting started with the Multi-BBS Interface in TW2
  412. ---------------------------------------------------
  413.  
  414. There has been several problems with writing Tradewars over the past
  415. couple of years. The most prominent is the fact that a different 
  416. interface had to be written for each separate BBS type. This led to
  417. some BBS types to have a -newer- version of Tradewars than another.
  418. This usually upsets the users, and eventually the SysOps as well.
  419. It was decided that Tradewars will now be released as a SINGLE program
  420. to be compatible with many different BBS types. This should solve
  421. any problems with obsolesence.
  422.  
  423. As you will see below, 4 out of the supported BBS types use the 
  424. DORINFOx.DEF file to pass info onto Tradewars (or any door program)
  425. So far this is the most supported standard, and though that really 
  426. isn't saying much at the moment, I hope some more BBS program authors
  427. choose this means eventually.  I don't really expect that to happen
  428. but it would be nice.
  429.  
  430. NOTE: There is an official version of Tradewars Ver. 2 for TBBS users.
  431. TBBS operates much differently so a different program must be used.
  432. Contact Gary Funk at 1-501-442-8777 for the TBBS version.
  433.  
  434. You must first begin by setting the BBS type when you are asked about it
  435. by the init program. The BBS types are as follows:
  436.  
  437. 0 - RBBS    (17.x default)             (DORINFOx.DEF & MESSAGES)
  438. 1 - PCBoard (14) & Searchlight         (PCBOARD.SYS)
  439. 2 - OPUS                               (LASTUSER.BBS)
  440. 3 - QBBS & FoReM & TPB & T.A.G.        (DORINFOx.DEF)
  441. 4 - Wildcat                            (CALLINFO.BBS)
  442. 5 - GTPowercomm                        (GTUSER.BBS)
  443. 6 - Phoenix                            (INFO.BBS)
  444. 7 - GAP                                (DOOR.SYS)
  445. 8 - Spitfire BBS                       (SFDOORS.DAT)
  446.  
  447. RBBS mode:
  448. ----------
  449.  
  450.  TW2 now uses RBBS' DORINFOx.DEF file to get info from the BBS, and uses
  451. the messages file only for getting the current status of snoop. The MESSAGES
  452. file can also be specified. The messages file can be located anywhere you
  453. want it.  The DORINFOx.DEF file MUST be in the same directory as TW2.
  454.  
  455.  If you are using GMon, you can tell TW to return to it (bypassing the
  456. MONITOR1.EXE program). You can tell TW to look for it when you initialize
  457. the program, OR you can always change it using the TradeWars Editor.
  458.  
  459. RBBS SysOps, TW does not file and record lock like RBBS! DOS 3.1 (or greater)
  460. must be used, and DOS SHARE must also be loaded in each node.
  461.  
  462. PCBoard/SearchLight Mode:
  463. -------------------------
  464.  
  465. *NOTE*  Tradewars 2 release 6.1(and above) will interface only to PCBoard 14!
  466.  
  467. /P:  -  PCBoard SysOps,  use this command line switch to specify the 
  468.         PCBOARD.SYS file which this copy of TW is supposed to use.
  469.  
  470.         Example:     /P:C:\PCB2\PCBOARD.SYS
  471. Also allowable is:   /P C:\PCB2\PCBOARD.SYS
  472.  
  473. Tradewars will get all the info it needs from the PCBOARD.SYS file. Such 
  474. as Graphics mode, Bps rate, Com port, etc. You do not need to use any
  475. extra command line options, just /P.
  476.  
  477. SearchLight SysOps
  478. ------------------
  479.  
  480. First, you will need a program I have written called: 12TO14.EXE  This
  481. will be used in a batch file we'll create below. You should have 12TO14.EXE
  482. in your SearchLight BBS directory. (You can find 12TO14.ZIP on my system)
  483.  
  484. In your DOORS.DEF file you will need a line similar to the line below:
  485.  
  486. 0;0;0;?;TradeWars 2 Rel. 10.0;C:\SLBBS;TW2 /P:PCBOARD.SYS
  487.  
  488. Where 'SLBBS' is your SearchLight BBS directory and The '?' is the security
  489. level needed to run TW. These will vary from system to system. The last
  490. parameter must run TW and point to the correct PCBOARD.SYS file to use.
  491. You must then specify a filename in General Configuration option number
  492. 19. This is the filename used for the PCBOARD.SYS file. For example, to use
  493. the above example you'd enter  C:\SLBBS\PCBOARD.SYS   in parm # 19.
  494. Next create a batch file called TW2.BAT It should look like this:
  495.  
  496. 12TO14 C:\DOORS\TW2\
  497. CD\DOORS\TW2
  498. TW2 %1
  499. CD\SLBBS
  500. EXIT
  501.  
  502. C:\DOORS\TW2  is your TradeWars directory
  503. C:\SLBBS      is your SearchLight directory
  504. 12TO14 will convert your C:\SLBBS\PCBOARD.SYS into a proper format and
  505. write it as C:\DOORS\TW2\PCBOARD.SYS.
  506.  
  507. Opus mode:
  508. ----------
  509.  
  510.   To run TW2 under Opus you will need to use several command line para-
  511. meters. The first is the '/P:' parameter. Use this to specify the
  512. LASTUSER.BBS file like so:  /P:C:\BBS\LASTUSER.BBS
  513.  
  514. Also, you need to specify the com port in a similar manner, for COM1
  515. use a line like this: /C1    
  516. COM2 would be: /C2  etc.etc.
  517.  
  518. If you have a high speed modem, and you have it 'locked' at a certain
  519. rate (usually 19200, or 38400) specify that speed like so:
  520. /S19200
  521.  
  522. /G will turns ANSI color/graphics on  (default is off)
  523.  
  524. /Txx  will set the time limit allowed to this user this call.
  525.       /T45 would set the total time limit for this call to 45 mins.
  526.       For instance, Say a user logs on and receives 45 total time.
  527.       They spend 30 minutes in the BBS then decide to play TW. 
  528.       They will receive 15 minutes to play the game.
  529.  
  530. QBBS & FoReM & TPB mode: (05/01/88)
  531. ------------------------
  532.  
  533.  In the QBBS mode, TW2 will read the DORINFOx.DEF (same as RBBS) file.
  534.  (it must be in the same directory as TW2.EXE.)
  535.  
  536.   Make sure you tell TWRI that you are running BBS type 3. (You can use
  537. TWEdit to do the same thing.
  538.  
  539.   ** NOTE: The TPB people apparently don't want to have anything to do with
  540.  doors. They won't support their own door interface, so, call me if you
  541.  have problems, and I will TRY to help. I know nothing of TPB other than 
  542.  that it creates an 'almost' correct DORINFOx.DEF file.
  543.  
  544. WildCat mode:
  545. -------------
  546.  
  547. /P:  -  Wildcat SysOps,  use this command line switch to specify the 
  548.         CALLINFO.BBS file which this copy of TW2 is supposed to use.
  549.  
  550.         Example:     /P:C:\WCAT\CALLINFO.BBS
  551. Also allowable is:   /P C:\WCAT\CALLINFO.BBS
  552.  
  553. Tradewars will get all the info it needs from the CALLINFO.BBS file. Such 
  554. as Graphics mode, Bps rate, Com port, etc. You do not need to use any
  555. extra command line options, just /P.
  556.  
  557.  TW2 will read in the name of the CALLINFO.BBS file then read it to get the
  558. current users parameters.  Make sure you tell TWRI that you are using
  559. Wildcat. (you can use TWEDIT to do the same thing.)
  560.  
  561. GT Powercomm mode:
  562. ------------------
  563.  
  564.   To run TW2 under GT you will need to use several command line para-
  565. meters. The first is the '/P:' parameter. Use this to specify the
  566. LASTUSER.BBS file like so:  /P:C:\GT\GTUSER.BBS
  567.  
  568. Also, you need to specify the com port in a similar manner, for COM1
  569. use a line like this: /C1    
  570. COM2 would be: /C2  etc.etc.
  571.  
  572. If you have a high speed modem, and you have it 'locked' at a certain
  573. rate (usually 19200, or 38400) specify that speed like so:
  574. /S19200
  575.  
  576. Phoenix BBS mode:
  577. -----------------
  578.  
  579. To run TW under Phoenix you simply need to have one command line parameter:
  580. the /P: parameter. Use it to specify which INFO.BBS file to use like so:
  581.  
  582. C>TW2 /P:C:\BBS\INFO.BBS
  583.  
  584.  
  585. GAP (Door.Sys mode):
  586. --------------------
  587.  
  588. To run TW under GAP you need to specify which DOOR.SYS file to use like so:
  589.  
  590. C>TW2 /P:C:\GAP\DOOR.SYS
  591.  
  592. Spitfire mode:
  593. --------------
  594.  
  595. To run TW under Spitfire you need to specify which SFDOORS.DAT file to use
  596. like so:
  597.  
  598. C>TW2 /P:C:\SP\SFDOORS.DAT
  599.  
  600. Switching over to the new version of TW2.
  601. -----------------------------------------
  602.  
  603. When switching over to version 10, you will need to completely re-init the
  604. game. The data files have been totally overhauled. They contain more room
  605. for more info, but take up about 2/3 the disk space.  Use TWRI to do
  606. the initing process. It will create the files needed by TW version 10.
  607.  
  608. Having problems?
  609. ----------------
  610.  
  611.   I have added in new code to prevent most any error so you won't have a 
  612. 'hung' system.  If any files are missing, TW2 will recover from the error
  613. gracefully. If you see what looks like an error message, right down exactly
  614. what it says, if you can fix the problem (for instance an opening screen file
  615. is missing) by all means do so. Otherwise, let me know the EXACT message
  616. it prints.
  617.  
  618. Other problems that creep up also are usually files missing. Make sure
  619. That all files listed above in the 'run-time list' are on the same
  620. drive/path as TW2.EXE.  Along with  MESSAGES, DORINFOx.DEF. (If you are
  621. using RBBS-PC) or the files associated with the other BBS types.
  622.  
  623. NOTICE:  TW2.DAT has been eliminated in release 10.0 (or greater)
  624.  
  625.  
  626. More problems you say?
  627. ----------------------
  628.  
  629. If you seem to have found a bug, I highly recommend sending me capture
  630. file of the problem. Usually just a note with an explaination just
  631. can't help me fix a thing. A note AND a capture file is best. The capture
  632. file should be of the complete session, and should have the Tradewars
  633. version number in the file, ie: Tradewars Version 2 Release 5.24 06/19
  634. (that is usually the first line that Tradewars prints out when it is run)
  635. If that isn't in there, or if its an older version, I won't be able to do
  636. a thing about fixing your problem. I find I can fix bugs that are explained
  637. with a capture file in about 1/100 the time!, no kidding!.
  638.  
  639. Of Course, I can only support the version I release. Any other version I
  640. will refuse to support. The reason for this is simple, I know how my code
  641. works, and I know it pretty darn good. Some other version is probably
  642. written in a completely different programming language, and modified besides.
  643.  
  644. Contact me here at The Reno RBBS:
  645. I'm very willing to help SysOps with Door problems. (any problems.. not
  646. just with my Door games.)  So give me a ring!  If you wish to check for
  647. the latest in Tradewars releases, Please J)oin the DOORS conference after
  648. you log onto The Reno RBBS.  Everyone has full access on the first call.
  649.  
  650. Special Thanks to :
  651.  
  652. Chris Sherrick
  653.  
  654. Jim Leenan         Andrew Hoag        Rick Hines
  655. Roger Reesor       Paul Waldinger     (and everyone else who had a hand in
  656. Gary Funk          David Friedman      this thing!)
  657. Eric Carr          John Zimmerman
  658. Alan Davenport (well sorta..)  
  659. Some For their help in added mods to make TW2 the best door game known to
  660. modern man, and others for their help testing and reporting bugs.
  661.  
  662. John Morris
  663. The Reno RBBS
  664. 2620 Emily St.
  665. Reno, NV 89503
  666.  
  667. 702-746-1364 DATA
  668. 702-746-1365 DATA
  669. 702-746-1358 VOICE
  670.  
  671.  
  672. Appendix A:
  673. -----------
  674.  
  675.   TW Philosophy (or why the official version 'is the way it is')
  676.  
  677.   I get complaints, and ideas sent to me all the time concerning TW2. Most
  678. SysOps wishing me to add this or that to the program 'because another
  679. version of TW has it'.
  680.   Though most people won't believe it, there is a method behind my madness.
  681. Compare the way you have your game set-up to mine:
  682.  
  683.   My players start with 25 fighters, 500 credits and 25 holds. They are
  684. allowed 65(!) turns per day, max! Their maximum amount of holds is 50.
  685. Believe it or not this is THE best way to set the game up.. The business
  686. where a user gets 150-200 turns a day turns TW into a 'playable' game, but
  687. it is only playable for a couple of weeks. Lets face it folks, when you
  688. allow a user to rape ports and trade for 150 + turns, your ports will dry
  689. up in no time at all. Of course the pirate copies of TW try to deal with
  690. this with bells and whistles. With my game set up as above, the game ends
  691. up being not only more enjoyable in the long run, but it will end up
  692. being far and above a more competitive game. I don't believe in allowing
  693. ANY player to attack 'ANONYMOUSly' from several sectors away with a battle
  694. group.. That is NOT Tradewars. That is wimp wars.
  695.  
  696.   The key word which has made TW popular (and will continue to do so) is
  697. BALANCE! This balance is achieved by keeping the game from getting out of
  698. hand. 150+ turns is out of hand. More than 50 cargo holds is out of hand.
  699. I could go on and on. The SysOp should have to set up ZERO planets. (yes,
  700. 0!) The users should have this responsibility. Tradewars was designed
  701. to be able to run without ANY SysOp intervention. (after setting it up)
  702. I think SysOps would be suprised just how well the game does work without
  703. any intervention.
  704.   
  705.   Of course this all just my opinion. Most SysOps will look at this little
  706. message and start hooting and jeering, or just plain laugh.. But don't
  707. knock it till ya try it.
  708.  
  709. A little added stuffs (7/89)
  710. ----------------------------
  711.  
  712.   I just heard a few days ago that good ol' Alan D. is planning on putting
  713. out another version of 'his TW'..  One of the neatest features (I hear) is
  714. that there will be computer function which will allow the game to take
  715. your turns for you. I don't mean to laugh, but lets face it, that is a joke!
  716. As the days go by, the pirate version he puts out becomes more of a 
  717. mockery than anything else. I don't believe in legal action (it'll hurt
  718. TW more than help it) and the guy doesn't listen when I ask him politely
  719. to stop putting his own version out. The only way to get the guy to stop
  720. is for YOU the SysOp to stop using his version! It's a case of ethics,
  721. and Alan Davenport has none. Besides, the game is copyrighted, and he is
  722. in constant violation of that copyright.
  723.   The official release will continue on its current course of keeping the
  724. game a challenge. The players will actually have to THINK! (wow! what a
  725. concept, huh?) Of course new features will be added. Some will help the
  726. player play the game, but most will be invisible to the player, and make
  727. the game ever more interesting.
  728.   For the last three years, TW2 has been a one man operation (ME), and
  729. I have a rough time finding time to spread the word on pirate versions
  730. versus the official version. I could not tell you how much it would mean
  731. to me if you could help me do that.
  732.  
  733.   -- John Morris -- Co-Author
  734.  
  735.  
  736. Appendix B:
  737. -----------
  738.  
  739. How to interface your BBS to TW2
  740. --------------------------------
  741.  
  742. Your program will need to create a small, simple text file known as the
  743. Door Info file. 
  744.  
  745. For Single node BBS's this file will be named:
  746.    DORINFO1.DEF
  747.  
  748. For multi-node BBS's this will be named like so:
  749.    DORINFO1.DEF for node 1,     DORINFO2.DEF for node 2,   etc.
  750.  
  751. TW accepts a command line parameter which tells it which node (if any) it
  752. is running on. If there is no command line parameter then TW looks for
  753. DORINFO1.DEF. If TW sees this:
  754.  
  755. TW2.EXE 2
  756.  
  757. it will look for DORINFO2.DEF, if it was a '1' then it would look for
  758. DORINFO1.DEF.. etc. etc.
  759.  
  760. The format of the file is as follows:
  761.  
  762. BBS Name
  763. SysOps First Name
  764. SysOps Last Name
  765. Com Port
  766. Baud and Parity
  767. Network Type
  768. Current Users First Name
  769. Current Users Last Name
  770. Current Users City
  771. Graphics
  772. Security Level
  773. Minutes left in session
  774. Fossil driver present
  775.  
  776. This file typically looks like this:
  777.  
  778. Example 1:                               Example 2:
  779. ----------                               ----------
  780. (remote user at 2400, even parity,       (local user, in this case the SysOp
  781. 7 data bits, no graphics, and RBBS       graphics are on, and a fossil driver
  782. is NOT using fossil driver)              is present)
  783.  
  784. THE RENO RBBS                            THE RENO RBBS 
  785. JOHN                                     JOHN
  786. MORRIS                                   MORRIS
  787. COM2                                     COM0
  788. 2400 BAUD,E,7,1                          9600 BAUD,N,8,1
  789.  0                                        3
  790. JOE                                      SYSOP 
  791. USER   
  792. RENO, NV                                 RENO, NV
  793.  0                                        2
  794.  5                                        20
  795.  57                                       119
  796.  0                                       -1   
  797.  
  798. Typical quirks with the DORINFOx.DEF file and TW2
  799. -------------------------------------------------
  800.  
  801. To get TW to look for a DORINFOx.DEF file, set the BBS type in the TW2.DAT
  802. file to 3.
  803.  
  804. 1. A local user is determined when the Com Port is set to:  COM0
  805.    Also a 'last resort method' is to set the bps rate to 0 (NOTE: this last
  806.    method is not used in the standard DORINFOx.DEF file).
  807.  
  808. 2. When the sysop is using the game, the current users first name is 'SYSOP'
  809.    and the current users last name is ''  (a null string, the only chars
  810.    found on the line are a carriage return/line feed combo) 
  811.    Also acceptable is the users first name is the same as the SysOps first 
  812.    name, AND the users last name is the same as the SysOps last name, but
  813.    this is acceptable only as a last resort.
  814.  
  815. 3. Graphics are off when a '0' is found in the graphics field. Any number
  816.    above 0 (typically 1 or 2) is considered 'graphics/color ON' by TW.
  817.  
  818. 4. Note the baud and parity field. Whatever the baud and parity it MUST be
  819.    in the above format. Some more examples:
  820.  
  821.    300 BAUD,N,8,1
  822.    1200 BAUD,E,7,1
  823.    19200 BAUD,N,8,1
  824.   
  825.    TW parses out the ' BAUD' part of the string.. so it MUST be there.
  826.  
  827. 5. The Fossil driver field is one of two settings: 0 (not present) or,
  828.    -1 (present)
  829.  
  830. 6. Though TW2 10.0 doesn't use the BBS Name, SysOps first OR last name
  831.    Network Type, Users City, and Security Level fields, these lines still 
  832.    must be present in one form or another.
  833.  
  834. 7. Everything in this file should be in CAPS, otherwise no telling
  835.    what will happen.
  836.  
  837. 8. The space in front of the integers doesn't actually need to be present
  838.    it is just a by product of the way BASIC prints numbers into a file.
  839.  
  840. I personally like this file because of its small size and simplicity. And
  841. I wish more BBS programs would adopt it. If this appendix doesn't contain
  842. enough info, just call and scream at me, or drop me a line in the mail or
  843. on my BBS telling me what I missed.. I'll fix it.. I promise!
  844.  
  845.  
  846.