home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / twterm30.zip / TERMTIPS.DOC < prev    next >
Text File  |  1994-07-06  |  25KB  |  509 lines

  1. TWTERM is a very customizable program. And as such, to be real successful
  2. with it you should understand how it works and gets the data it needs to
  3. work to it's fullest. Just like anyone can drive a car, anyone can start
  4. TWTERM. But to get a full understanding of what it's capable of, you should
  5. get under the hood and learn it's inner workings. Hopefully by reading
  6. this file, TERMHELP.DOC, SCRIPT.DOC, and MODMHELP.DOC you'll get an insight
  7. into most of it. The rest will come with practice. So don't be timid...
  8.  
  9. Play with TWTERM first off-line, then read all the docs. Go thru TWTERM
  10. again off-line to try out the things you learned from the docs. Once familiar
  11. with TWTERM jump into a game of TW and enjoy.
  12.  
  13. **************************************************************************
  14. GLOSSARY OF TERMS
  15.  
  16. BUILT-IN  These are macros that have the coding in TWTERM itself. These
  17. MACRO     macros can not be modified.
  18.  
  19. CAPTURE   This usually means a text file that is created while playing that
  20. FILE      "captures" everything that comes across your screen to a text file.
  21.           In TWTERM this capture file is given an extension of .LOG and is
  22.           also referred to as a LOG file.
  23.  
  24. CIM       Stands for Computer Interrogation Mode. This is a feature of Trade
  25.           Wars, that allows a user to get 3 types of information. 1) Info on
  26.           all your explored sectors. 2) Info on all your found ports. 3) Paths
  27.           between sectors. TWTERM uses this feature of TW to gather some of
  28.           info it needs to run.
  29.  
  30. COMM      This refers to the communication program you use to connect
  31. PROGRAM   to a BBS. Some popular ones are.. Telemate, RipTerm, Qmodem
  32.           and others.
  33.  
  34. DATABASE  Each game of TW that you play in will have it's own set of files
  35.           that pertain to that game. These files are collectively referred
  36.           to as that games Database. Each database for each game of TW will
  37.           have it's own unique "GameName".
  38.  
  39. EDITABLE  These are macros created with TWTERM's script language, AND are
  40. MACRO     stored in the TWMACROS.FIL file. They get their name because they
  41.           can be edited/created on-line or off-line while in TWTERM.
  42.  
  43. GAMENAME  This refers to the name you assign to a particular game of TW.
  44.           All files created while playing that particular game of TW will
  45.           have GameName for the file name.
  46.  
  47. HUGE      These are macros created with TWTERM's script language. The
  48. MACRO     difference of these from Editable ones is that these are more than
  49.           one line long, and thus can not be saved in TWMACROS.FIL. Instead
  50.           each macro is saved in it's own .MAC file for TWTERM to access and
  51.           run.
  52.  
  53. LOG FILE  See CAPTURE FILE
  54.  
  55. PRT FILE  When gathering your port info from TW's CIM mode, TWTERM gives
  56.           the file an extension of .PRT.
  57.  
  58. SCT FILE  When gathering your sector info from CIM mode, TWTERM gives the
  59.           info an .SCT file extension. This is your SCT file
  60.  
  61. ***************************************************************************
  62. TIP'S ON GETTING THE MOST FROM TWTERM
  63.  
  64. Before you log into a game of TradeWars, I highly recommend you play with
  65. TWTERM off-line first and configure it to work with your modem.
  66.  
  67. Simply specify a "GameName" for each TW game you will be playing in.
  68. For instance I play on PhotoPro BBS and Warlock's Domain BBS. I specify two
  69. gamenames, PP and WD. TWTERM then creates a configuration file for each.
  70.  
  71. To specify a GameName, you can enter it on the command-line or from within
  72. TWTERM when you first start it.
  73.  
  74. Now that you have your games configured, you're ready to play. You'll need
  75. to use your regular Comm program to dial and log into a game of TW. You can
  76. then EXIT or SHELL from your Comm program and start TWTERM. You can start
  77. TWTERM after you're into TW already or as the BBS loads the TW game. If you
  78. plan to use the "Find Traders" feature, then I suggest you start TWTERM as
  79. TW is being loaded. You then will have time to open a capture (LOG) file so
  80. you can record TW's opening messages. The ones that report which ships have
  81. entered sectors where you have deployed fighters. You'll need this info
  82. later when tracking opponents.
  83.  
  84. Once TWTERM is started, you should see your ships shielding being raised
  85. and the main TWTERM ship console. You are now in the default 24 line display
  86. mode. To switch to a 41 line display, hit <CTRL> Z.
  87.  
  88. After the shielding is raised.. you should see the game of TradeWars being
  89. displayed to the top half of the screen. If you don't see this, then stop
  90. and read MODMHELP.DOC. If you get characters that look like line noise, or
  91. get nothing at all.. then you have TWTERM configured incorrectly. MBBS users
  92. should read the MODMHELP.DOC for other problems unique to MBBS that will
  93. cause this, eventhough TWTERM is configured correctly.
  94.  
  95. The main screen displays all the <CTRL> and "F" keys that are at your
  96. disposal. There is a large patterned grid on the right. Here will be
  97. displayed most of TW's commands that you can use while in the game. You
  98. should also notice some Cyan colored windows. These display some of your
  99. current stats:
  100.  
  101. GAME NAME   current games database name. This name is used to access all
  102.             the data files of that game.
  103.  
  104.        SD   is the location of Stardock. If you have found Stardock and have
  105.             used the "SCAN A LOG" feature, then you should have the location
  106.             of Stardock saved in your .DAT file. This location is taken from
  107.             the .DAT file and displayed here so you'll never again forget the
  108.             sector Stardock is in.
  109.  
  110.     KNOWN   when you load the .SCT and .PRT files for the game, TWTERM
  111.             calculates the percentage explored and displays it here.
  112.  
  113. LAST PATH   this reminds you of the last path you took. The sector on the
  114.             right is the current sector you are in. The sector on the left
  115.             is the sector you just came from.
  116.  
  117. LAST THEFT  this displays the last port you robbed or stole at. Helpful in
  118.             case you forget, don't want to rob the same port twice in a row.
  119.             
  120. TWTERM can be used as an interface to TW. But if you want real power,
  121. and the ability to use many of TWTERM's features, you'll need a database
  122. to work with. You're main database will consist of three files. From these
  123. 3 files TWTERM creates other files that can be examined and used while on or
  124. off-line.
  125.  
  126. Two of the files you'll need, can be downloaded from TW itself. To download
  127. these, you must be in a game of TW. Then use the "CIM Access" feature
  128. <CTRL> C. TWTERM downloads a .SCT and a .PRT file that contain info on all
  129. the sectors you have explored and ports you have found.
  130.  
  131. The third file you'll need is a .DAT file. This file contains info on the
  132. game, all your planets, mines, deployed fighters, ship locations, class 0's,
  133. busted ports, etc.. This .DAT file is created by yourself. To create this
  134. file, you'll need to:
  135.  
  136. 1) Open a Log file ("F3")
  137. 2) Display from TW the game stats("V") and all your personal and corporation
  138.    info. I've included a macro in TWTERM that will help you in displaying
  139.    this info. Run TWSTATS.MAC. You can also edit TWSTATS.MAC to fit your
  140.    personal needs.
  141. 3) Run the "Scan A Log" feature to gather all this data and save it in the
  142.    .DAT file.
  143.  
  144. Congratulations! You've now configured TWTERM to work with the games you'll
  145. be playing in, and you've got you're database for each one. Now you're ready
  146. to start putting TWTERM to work for you.
  147.  
  148. I run daily at the end (and at the beginning of my playing session <CTRL> C
  149. (CIM Access) to get me the latest info on my explored universe. I also run
  150. the TWSTATS macro to keep me updated as to the location of my assets.
  151.  
  152. In addition, there are some other features that can be put to good use.
  153. This is very helpful if you plan to do  some off-line strategy mapping when
  154. done playing. You may also want to do the above when you first log in to
  155. the game so you'll have the latest updated info when you play.
  156.  
  157. F4 is the key to use when you want to gather info on your universe. Then use
  158. the F1 key to view all this info. I suggest running these features as you
  159. need them.
  160.  
  161. F10, the Utility Menu is the place where you can store/save the commands of
  162. other programs you would like to run from within TWTERM. I mostly use this
  163. for running DOS commands (that way I don't have to shell to DOS and the
  164. entries are saved in a text file for later use also). I like to rename files
  165. or move files about here.
  166.  
  167. F7, the Macro Menu is where you can create and save your own personal macros.
  168. For instance, I can't anticipate every players playing style. So if there
  169. is not a Built-In macro to do something you need done, you can always
  170. customize TWTERM to your needs by creating your macros here using the TWTERM
  171. script language. I know what you're thinking... "I don't know how to code
  172. those things". Let me tell you, this language is so simple my 8 year-old can
  173. do it. There are basically only 1 command you need.. SEND which sends a
  174. text string to the modem (just like your keyboard sends input to the computer)
  175. and then it waits for the next prompt to be received from the modem, where
  176. it then returns control back to TWTERM (unless you specified another SEND).
  177. I've included a few macros here for you to play with and study. TWSTATS.MAC
  178. and TWMACROS.FIL are text files that contain the macros. Read more about
  179. these later in the docs.
  180.  
  181. F5 is the map screen where you can view any sector and it's surrounding
  182. sectors. Good to use when searching for a home sector, or for checking
  183. out others homes sectors. I also use this a lot when I want to block
  184. Stardock, as I can study the warps in and out. F5 is also where you can get
  185. info on particular ports in the game. This info tells what that port buys
  186. and sells and how much is on hand.
  187.  
  188. <CTRL> C is the Flight Recorder. A lot of folks ask what this is used for
  189. and how it differs from a capture file. A capture file (created by using F3)
  190. is a text file of all the text that was displayed to the screen AFTER the
  191. ANSI escape codes are taken out. With the Flight Recorder, these ANSI codes
  192. are kept in. That allows one to actually replay your playing session
  193. off-line in full color. JUST AS IF YOU WERE ON-LINE. Why would you do such
  194. a thing? For one I find it easier to study my game play by watching this
  195. instead of reading a capture file. Secondly, you could send your playing
  196. session to a teammate who can replay it on his computer. Thus your teammate
  197. can open and close capture files of your playing session and gather data
  198. from it. A third use, may be in creating a library of your game. I rename
  199. each days flight recorder file to the gamename and date. I then save it.
  200. I have one for each day I've played. I can now replay and review any one of
  201. my playing sessions at any time. Did you lose that scrap of paper that told
  202. where Ferrengal was? No prob, pull out the recording that has it, and get it
  203. again. you'll never lose another bit of data with this baby. Lose your .DAT
  204. file and now you don't know where your assets are? Use this to create
  205. another .DAT file.
  206.  
  207. F2 is the Ship Control Center. Here you can set a password for your ship
  208. (in case you want to use the password in macros), tell TWTERM whether your
  209. current ship has a T-Warp Drive or Planet Scanner (needed by some of the
  210. Built-In macros), and for calculating the distance from any sector
  211. to the ships in your fleet (real helpful if your current ship has a small
  212. transport range).
  213.  
  214. "Power-Pak" owners get even more features. They have access to the Built-In
  215. macros displayed on the F7 menu. They have access to all the features listed
  216. on the F4 menu. I hope you decide to order TWTERM's Power-Pak and help the
  217. growth of TWTERM. In exchange I promise to bring you more exciting features
  218. to enhance your playing session.
  219.  
  220. ***************************************************************************
  221. FREQUENTLY ASKED QUESTIONS
  222.                       ---------------------
  223.  
  224. Q> I'm getting "Out of String Space" errors when scanning a log file. Help!
  225.  
  226. A> There are a lot of things to scan in a .LOG file. Unfortunately I can't
  227. allocate unlimited memory to each item. So in essence, you have more assets
  228. then I thought one would have. What would be real nice.. is if you could
  229. send me your .LOG file (via file attachment at my support BBS or via US Mail)
  230. That way I can run it here and see what happens, make corrections, and send
  231. you an updated copy.
  232.  
  233.                       ---------------------         
  234.  
  235. Q> I keep forgetting what each Icon means. Is there help for me?
  236.  
  237. A> For a brief description of what each Icon stands for, hit "F1" then "A"
  238.  
  239.                       ---------------------
  240.  
  241. Q> How can I print the MAP screen (F5) on my printer?
  242.  
  243. A> First you need a printer that will support printing graphics. See your
  244. printers manual for more on this. Secondly you need to load a graphic
  245. driver BEFORE starting TWTERM. DOS supplies one of these called GRAPHIC.COM.
  246. However you can also search your local BBS for one. Then while in TWTERM
  247. use your keyboards PRINT SCRN key.
  248.  
  249.                          ---------------------
  250.  
  251. Q> I really need to do some trading. How do I find the nearest Paired-Port
  252. to the sector I'm in?
  253.  
  254. A> On the Data Screen (F4), there is a feature (N) that will display the
  255. nearest ports to any sector you specify. For this feature to work it needs
  256. a .PRT file (CIM's port info file) to scan and locate near ports. If you
  257. don't have a .PRT file, you can get one by running "<CTRL> C" while on-line.
  258.  
  259. With a .PRT file, TWTERM can locate the nearest ports. But which ones are
  260. Paired-Port ones? TWTERM will mark it as a Paired-Port with a "PP" in the
  261. Nearest Ports Listing. For it to know which is a Paired-Port you need a
  262. .BST file for TWTERM to access. You can create a .BST file first by hitting
  263. "F4" then "P".
  264.  
  265. In review.. you need a .PRT and .BST file to be alerted to nearest Paired
  266. Ports when running the "Nearest Ports" feature.
  267.  
  268.                       ---------------------
  269.  
  270. Q> I write a lot of macros that I store in .MAC files. Is there a way I can
  271.    edit them while in TWTERM?
  272.  
  273. A> Sure. You can edit them in a Text Editor/Word Processor without ever
  274. leaving TWTERM.
  275.  
  276. First let me state, that TWTERM uses a lot of memory so you may not have
  277. much left over for running a Text Editor. I recommend TED3.COM, because
  278. it uses very little memory. Download it from a local BBS.
  279.  
  280. Once you have a Text Editor, you can use TWTERM's Utility Menu (F10) to
  281. start the Editor and load any text file you wish to edit. This works
  282. great for editing .MAC files.
  283.  
  284.                       ---------------------
  285.  
  286. Q> What is the Flight Recorder for?
  287.  
  288. A> First let's understand how the Flight Recorder works (<CTRL> B). When
  289. on-line, it captures all incoming data from the modem and saves it to disk
  290. in a text file called TWRECORD.TWT. When off-line, it displays the
  291. TWRECORD.TWT file to the screen, just like you were playing in a game of TW.
  292.  
  293. This .TWT file can be used off-line for creating capture files, writing
  294. macros, exchanging with team-mates so they can gather data from them, and
  295. more. Only limited in use by your imagination.
  296.  
  297.                       ---------------------
  298.  
  299. Q> Can I use TWTERM in local mode?
  300.  
  301. A> I haven't tried it, but here are some thoughts. Try using a NULL modem
  302. to send TW data out one port and in another. Ask you local SYSOP on how to
  303. do this.
  304.  
  305. Another way, is to use some multi-tasking software like DesqView. Then in
  306. TWTERM specify a com port of 0 when playing TW. Good luck and hope one way
  307. works for you. If it does let me know.
  308.  
  309.                       ---------------------
  310.  
  311. Q> How can I see if a certain file exists in my TWTERM directory?
  312.  
  313. A> Push "F1" then "Z" to see a display of files in the current directory.
  314.  
  315.                       ---------------------
  316.  
  317. Q> The gamename isn't the word "gamename"? How do I configure it?
  318.  
  319. A> The reason you need to give a name when starting TW, is because many
  320. folks play in more then one game of TW. I myself, am currently playing
  321. in 4 games.
  322.  
  323. Since each game needs it's own set of files, it would be ridiculous to
  324. name the databases for each game the same. How would you distinguish
  325. which file goes to which game?
  326.  
  327. So what you do is specify a name (of your choosing) when starting
  328. TWTERM. Then, whenever TWTERM creates a file that is unique to that game
  329. of TW, it fives the file that name.
  330.  
  331. For instance the boards I play on are listed below along with the name
  332. I've assigned to each game.
  333.  
  334. BBS name          Game Name
  335. PhotoPro!           PP
  336. Warlocks WAR
  337. French Flyer        FF
  338. Punkin Duster       PD
  339.  
  340. Now when I look thru my TWTERM directory, all files named "FF" belong to
  341. the TW game I'm in on French Flyer BBS.
  342.  
  343. When you specify a "GameName". TWTERM looks for a file with the same
  344. name and the extension of .CFG. If that file doesn't exist, TWTERM
  345. creates one (a configuration menu pops up for you to fill out).
  346.  
  347. Now you have a config file for that particular game of TW. Whenever you
  348. start TWTERM after that and specify that GameName it will load that
  349. config file and any other files that pertain to that game of TW.
  350.  
  351.                       ---------------------
  352.  
  353. Q> I can't get TWTERM to print a file.
  354.  
  355. A> "<CTRL> P" is the print menu. If that doesn't work with your printer
  356. then you may have a printer that is not compatible with TWTERM. Make
  357. sure first that TWTERM has the correct line port listed in it's config
  358. file. Push "F8" to see if the correct line port is specified.
  359.  
  360. If it is and it still doesn't work, then you'll need to customize TWTERM
  361. to work with your setup. Go to TWTERM's Utility Menu (F10). Here you can
  362. enter a DOS command to run.
  363.  
  364. Type in: COPY filename.ext PRN here. Now whenever you want to print a file
  365. use F10 instead of <CTRL> P. Simply type in the name of the file to print
  366. and run DOS's print command from here.
  367.  
  368.                       ---------------------
  369.  
  370. Q> When I start TWTERM, I keep getting a message saying "Can't Locate
  371.    TWTERM's graphic file". What does this mean?
  372.  
  373. A> TWTERM needs access to TWTERM.GFX which is a file with all the icons
  374. in it. Without that the program won't run. Make sure that file is in the
  375. same directory as TWTERM. If you don't have that file, then d/l TWTERM
  376. again.
  377.  
  378.                       ---------------------
  379.  
  380. Q> Somehow I manage to get the display to hang. No matter what keys I
  381.    press, I can't get the TW game to display again.
  382.  
  383. A> When this happens, it's best to exit TWTERM and restart your comm
  384. program. After your comm program gets the modem back in synch (when
  385. the TW game starts displaying), then you can exit your comm and go back
  386. to TWTERM. Hopefully you'll only have to do this on a rare occasion.
  387.  
  388.                       ---------------------
  389.  
  390. Q> I follow your instructions, but I can't get TWTERM to display my TW
  391.    game at all.
  392.  
  393. A> Make sure you have configured TWTERM for the correct Baud Rate,
  394. Com Port, IRQ, and handshaking. If you don't know what they are, then
  395. look up the correct settings in your comm program. Since your comm program
  396. works it must be using the correct settings. Most comm programs have a
  397. window that displays these settings. Use the same settings for TWTERM.
  398. Read MODMHELP.DOC for more info.
  399.  
  400.                       ---------------------
  401.  
  402. Q> When I display my Flight Recorder off-line, how can I slow the
  403.    display down?
  404.  
  405. A> Few things can be done. 1) Make sure Space Graphics are ON.
  406. 2) Switch to 41 line display  3) And hit your computer's "Turbo"
  407. button. You know, the one that toggles your computer speed from
  408. 33Mhz to 16Mhz or something like that. Usually on the front of your
  409. computer. don't forget to switch it back when done.
  410.  
  411.                       ---------------------
  412.  
  413. Q> I'm in a 3000 sector universe. I tried to do Level Diagramming
  414. but it was taking too long so I aborted it. Can't you break it down
  415. into 100 or 200 sector groups for each level?
  416.  
  417. A> Granted TWTERM is broken down into 3 levels. However you must do
  418. all the sectors at one time for each level. Remember though that TWTERM
  419. skips sectors where you have already found a path. So while it may take
  420. 10 minutes to do the first 1000 sectors in a 2000 sector game, it'll only
  421. take 5 minutes to do the second half. So don't be worried it starts off
  422. slow.. it picks up steam.
  423.  
  424.                       ---------------------
  425.  
  426. Q> TWTERM gives me two CIM files. An .SCT and a .PRT. I like using
  427. TWASSIST, but it needs one file with the two above combined. Can
  428. TWTERM add these two files together?
  429.  
  430. A> That is one of the gems of TWTERM. It's pretty customizable. To do
  431. the above you use TWTERM's Utility Menu (F10). Here you can execute DOS
  432. commands (amongst others). So why not set up a hotkey in TWTERM that uses
  433. a DOS command to combine the two. Type this in your utility menu and it
  434. will be saved for future use also:
  435.  
  436. COPY /A gamename.SCT+gamename.PRT TWASSIST.SCT
  437.         ^^^^^^^^     ^^^^^^^^
  438.          use the same "gamename" you gave TWTERM when loading
  439.  
  440. If you set the above command in the Utility menus 1 spot then you would
  441. access the Utility menu and run #1 to create the TWASSIST file. And you
  442. never have to leave TWTERM to do it.
  443.  
  444.                       ---------------------
  445.  
  446. Q> I ran one of the macros for trading and it hung, what did I do wrong?
  447.  
  448. A> TWTERM handles two versions of TW 2.0. The MBBS version and the Door
  449. version. If you are playing on the MBBS version you need to specify the
  450. /M switch. This way TWTERM will use the prompts for the MBBS version of TW
  451. when trading. (BTW, that works the other way too.. if playing in the Door
  452. version, don't use the /M switch)
  453.  
  454.                       ---------------------
  455.  
  456. Q> I play Trade Wars on a MajorBBS. When starting TWTERM, I get TWTERM
  457. screen ok, but I'm not seeing the game of Trade Wars. How come I can't
  458. get anything to appear on the top half of the screen?
  459.  
  460. A> This could be 2 things..one is that you may not have TWTERM configured
  461. properly. Go to F8 and see if the settings are the same there as you
  462. connected with.. 14.4 users should have CTS/RTS, while 2400 have NONE.
  463. Make sure the IRQ is the correct one, and the Baud rate. Read MODMHELP.DOC
  464. for more info.
  465.  
  466. The second is a problem unique to MajorBBS. Since it is multi-player you
  467. get stuff coming to your screen eventhough you push no keys.. Things like
  468. Log-on messages, Comm-Link messages, pages, subspace channels, etc..
  469. The BBS is constantly sending these messages to your modem.
  470.  
  471. Now when you exit (or shell) to DOS to start TWTERM.. these messages keep
  472. coming. Since you have no comm program controlling the modem these messages
  473. start filling up the buffer (especially at 14.4). Now, by the time you get
  474. TWTERM started, the modem has closed itself. Hence no TW display or message
  475. displays come in. Now your forced to exit TWTERM, restart your comm program
  476. to get the modem back in synch, and then try again.. what a hassle.
  477.  
  478. So to prevent the above from happening, here are some suggestions..
  479.  
  480. 1) BEFORE leaving your comm program, turn off all incoming messages. Later
  481. you can turn them back on while in TWTERM.
  482.  
  483. 2) Or.. Try to start TWTERM faster before your modem has a chance to screw
  484. up. The best way to do this is to use a .BAT file for starting TWTERM.
  485. I use one I named, TWTERM.BAT. When I exit my comm program, I run the .BAT
  486. file. The .BAT file takes me to my TWTERM directory, then starts TWTERM
  487. with the correct commands, then returns me to my comm program when done
  488. with TWTERM. Fast and easy.
  489.  
  490. If any of the above methods fail.. remember to go back to your comm
  491. program and get the modem back in synch before you try again.
  492.  
  493. ***********************************************************************
  494. FINAL TIPS
  495.  
  496. If you are upgrading this TWTERM from previous version, you may have to
  497. erase your games .CFG files. You will know it when TWTERM gags while
  498. it starts. This will happen if the version you are upgrading is
  499. TWTERM 2.1 or before. The formats in the .CFG files are different.
  500.  
  501. If you should encounter an error while using a feature of TWTERM, always
  502. check the data being read by TWTERM first before you blame it on a bug.
  503. Sometimes it is.. but much of the time, the error is caused
  504. by bad data being read. See if it is complete, in the proper formats,
  505. and with the correct information. If not.. you may have to get a fresh
  506. DATA file for TWTERM to process. Sometimes bad data gets saved due to
  507. line noise or other glitches of the BBS.
  508.  
  509.