home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 12 / CD_ASCQ_12_0294.iso / vrac / xmb11.zip / XMB.DOC < prev    next >
Text File  |  1994-01-07  |  11KB  |  238 lines
  1.                                XMB
  2.                      (X-wing Mission Builder)
  3.                            Version 2.0
  4.                         Shareware Edition
  5.  
  6.           Mission Builder for X-wing Space Combat Simulator
  7.  
  8.                     (C) Copyright January 1994
  9.                          by Neal Westfall
  10.  
  11.                          CIS:[70222,1164]
  12.               Internet: nwestfal@silicon.csci.csusb.edu
  13.  
  14. OVERVIEW:
  15.  
  16.      XMB is a utility for the popular LucasArts Entertainment game X-wing.
  17. It allows you to effortlessly edit or completely redesign X-wing mission
  18. files and briefing files.  It has been implemented using Borland's Turbo
  19. Vision interface library to facilitate ease of use.  Editing missions is as
  20. easy as picking up the ships with the mouse and moving them.  A briefing
  21. editor is provided as well, so you can provide briefing files with your
  22. missions.  Context sensitive help is available at the touch of a button.
  23.  
  24. IMPORTANT!:  XMB modifies data files which are distributed with X-wing
  25. and Imperial Pursuit.  It is strongly advised that before using this
  26. program, you back up all of your mission and briefing files.  Copy all files
  27. in the mission directory to another directory.
  28.  
  29. The author of this program makes no representations or warranties as to the
  30. suitability of fitness for any particular purpose of the provided software or
  31. documentation.  The program is provided "as is" to the user provided the user
  32. understands this and accepts these terms.  No warranties or guarantees are
  33. expressed or implied.  The author cannot be held responsible for any damage
  34. resulting from the use or misuse of the software.
  35.  
  36. The author has no affiliation with LucasArts Games, and the program in no way
  37. should be thought of as sponsered, sanctioned, or authorized by LucasArts
  38. Games in any respect whatsoever.
  39.  
  40. COMPUSERVE SWREG:
  41.  
  42.      XMB and XW-PLT can now be registered online on Compuserve via SWREG!
  43. See note on instructions of how to do this in the section below regarding
  44. registration.
  45.  
  46.  
  47. REVISION HISTORY (official releases):
  48.  
  49.      Version 2.0  - XMB now fully supports editing of B-wing mission files.
  50.                     Manner in which briefing texts are edited has slightly
  51.                     changed. All briefing text is now edited in the same
  52.                     manner, including the mission title. To edit the mission
  53.                     title, you must find it among the briefing texts. See
  54.                     note in document for explanation of this change.
  55.                     Briefing map tags can now also be edited. Previously
  56.                     XMB just blanked these out.
  57.  
  58.      Version 1.2  - Added Briefing Style Option which controls the color
  59.                     of the briefing map.  Changed buttons on briefing text
  60.                     selection dialog from "Ok" and "Cancel" to "Edit" and
  61.                     "Done", respectively, to avoid confusion.  Removed
  62.                     ascii chart and calendar as these were useless for this
  63.                     application.  The calculator is questionable, but I left
  64.                     that in for now.
  65.  
  66.      Version 1.1  - Clipboard features added.  Fixed problem of not being
  67.                     able to read several Imperial Pursuit briefing files.
  68.                     Somewhat improved calculations to get ships to appear
  69.                     properly on the briefing maps.  Ship formations now
  70.                     comply with those in "X-wing: the Official Strategy
  71.                     Guide."  Waypoints are now handled somewhat differently.
  72.                     Minor bug fixes.
  73.  
  74.                     Registered Version:  Added a cross reference feature to
  75.                     the ship dialog box.  This serves as an aid to debugging
  76.                     missions by showing how the other ships interact with
  77.                     the ship being edited.
  78.      
  79.      Version 1.0  - First official release.
  80.                     First version to have online help.
  81.  
  82. FILES IN THIS DISTRIBUTION:
  83.  
  84.      XMB.EXE      - main program file.
  85.      XMBHELP.HLP  - program help file.
  86.      XMB.DOC      - this file.
  87.      XMB.ICO      - Microsoft Windows 3.1 icon.
  88.      DESUPPLY.XWI - sample edited mission.
  89.      DESUPPLY.BRF - sample edited briefing file.
  90.      MISSIONS.TXT - file names for missions.
  91.  
  92. You can copy the sample mission and briefing files over one of your existing
  93. missions to play it.  I created this mission during the testing of the
  94. program.  To replace X-wing Historic Mission 1 with this one, do the 
  95. following:
  96.  
  97.      copy DESUPPLY.* WAISTEM.*
  98.  
  99. Make sure you have backed up the old mission if you want to restore it.
  100.  
  101. INSTALLATION:
  102.  
  103.      Copy all files in the archive to your XWING mission directory or
  104. anywhere in your path.  To start the program, just change to your XWING
  105. mission directory and type 'XMB' and the program will load.
  106.  
  107. For example:  copy *.* C:\GAMES\XWING\MISSION
  108.               cd C:\GAMES\XWING\MISSION
  109.  
  110. Type 'XMB' and you're ready to go!
  111.  
  112. FEATURES:
  113.        
  114.      General:
  115.        - Overhead map view editor window with five zoom magnifications.
  116.        - Briefing editor
  117.        - Online help system
  118.        - Clipboard features
  119.        - Cross Reference feature (registered version)
  120.  
  121.      Editing of the following is possible with XMB:
  122.        - Flight Groups, arrival times, etc.
  123.        - Objects, such as mines and asteroids
  124.        - Mission Time, Title, briefing text, etc.
  125.  
  126. NOTE ON BRIEFINGS -- PLEASE READ THIS!
  127.  
  128.     I have been contacted via E-mail on the Internet by Tim Scott, author
  129. of the programs XBRFRD and XBRFASM about integrating a fully fledged
  130. briefing editor into XMB.  XBRFRD is a program which can give you
  131. information about your briefing files, and XBRFASM is a program which can
  132. generate very professional style briefings, but acts somewhat like a
  133. compiler, so it may be difficult for some users to master.  I will be
  134. working with him to integrate his research into XMB to provide an easy
  135. interface for editing briefings which will include zooming, scrolling, etc.
  136. This has necessitated a slight change in the way briefing texts are edited
  137. in XMB.  All briefing text, including mission title, and with the exception
  138. of the briefing tags, will now be edited from the same list box. The reason
  139. for this is that the new briefing editing commands will determine when and
  140. where each of the briefing texts will appear, and this includes the title.
  141.  
  142. Tim's E-mail address is tscott@plains.NoDak.edu
  143.  
  144. SPECIAL CONSIDERATIONS:
  145.  
  146.     As new tours of duties are released compatibility problems may arise.
  147. Please be aware that this version of XMB has only been tested with the
  148. original X-wing missions and the Imperial Pursuit missions.
  149.  
  150.     When editing X-wing missions be aware that there is a limit to how many
  151. ships can be in play at any given time.  If there are too many ships, some
  152. may not appear when expected.  Also, if there are too many ships on screen
  153. at one time, you will notice a slowdown in performance of the machine,
  154. particularly with slower computers.  Trim down the number of ships if this
  155. becomes a problem.
  156.  
  157.     If you assign commands that have check marks next to them, don't forget
  158. to specify a command target.  These commands require a command target.  If
  159. not specified, undesirable results may occur (most likely in the form of the
  160. game abruptly exiting to dos).
  161.  
  162. REGISTERING XMB
  163.  
  164.      XMB is being distributed as shareware.  The funds are an encouragement
  165. to continue development and defray CIS connect time charges.  I have received
  166. very few registrations, but I know the program is in wide usage among FSFORUM
  167. members on Compuserve.  I do this mainly as a hobby, but what you see is
  168. still the result of many hours of programming time put forth by me.  I have
  169. priced the registration at what I call a "minimal" fee, which I don't think
  170. will break anybody.  Please understand that I'm not trying to make a killing
  171. or anything off of this, but your registration does help justify further
  172. development.  So PLEASE register if you like this program!!!
  173.  
  174. Registering will get you the following:
  175.  
  176.             - latest version on disk***
  177.             - features not available in SW version
  178.             - any related utilities I develop
  179.             - any missions or Tours of Duty I collect from users who don't
  180.               mind having them distributed
  181.             - continued development and improvement of the program
  182.             - free upgrades ($2.00 S/H)
  183.  
  184.      *** Compuserve members can alternately have it E-mailed to them.  Note
  185.          that this costs me about the same as sending a disk.
  186.      
  187.      I am looking into implementing some utilities to edit the yellow 
  188. scroll-up text and green Historic Combat mission descriptions.  These will
  189. be included with registered versions as they become available.
  190.  
  191.      Registered users can receive an updated copy of the program by
  192. sending $2.00 to the address below to cover shipping costs.
  193.  
  194.      Registration fees are as follows:
  195.  
  196.        X-wing Mission Builder only:       $ 10.00
  197.        XW-PLT Pilot Utility only:         $  6.00
  198.        Both Utilities:                    $ 15.00
  199.  
  200.      Send registration to:  Neal Westfall
  201.                             3061 Oregon St.
  202.                             Rialto, Ca  92376
  203.  
  204.      Registration can also be done online on Compuserve via SWREG.  The cost
  205. is going up to $18.00 from $15.00 to help defray Compuserve's "cut".  To 
  206. register in this manner, type GO SWREG at any ! prompt, select the appropriate 
  207. menu item and follow the instructions.  The shareware program ID is 1352.  
  208. Registering in this manner is the equivalent of registering both utilities as 
  209. described above.
  210.  
  211.      I can be reached via Compuserve at 70222,1164.  For those with
  212. Internet access, the address is nwestfal@silicon.csci.csusb.edu, although
  213. I am not too sure that mail can always get through.
  214.  
  215. ACKNOWLEGEMENTS
  216.  
  217.      XMB was developed using Borland's Pascal with Objects 7.0 and Dave
  218. Baldwin's excellent Dialog Design program.
  219.  
  220.      Much of the information was gleaned from the pages of Rusel DeMaria's
  221. book, "X-wing: The Official Strategy Guide", published by Prima Publishing.
  222. A must have guide for every X-wing pilot.  Written by the same author who
  223. wrote the original "Farlander Papers".
  224.  
  225.      Thanks to Herb Rowder and others in Compuserve's FSFORUM for the
  226. encouraging responses to the initial release of the program.
  227.  
  228.      X-wing, Imperial Pursuit, Star Wars, and any other references to
  229. Star Wars stuff are trademarks of LucasArts and Lucasfilm, LTD.
  230.  
  231. FINAL NOTE:
  232.  
  233.      I decided not to go into a detailed doc file, partly because I hate
  234. writing documentation, partly because most people don't read it, but mostly
  235. because it would be redundant in lieu of the online help system.  The help
  236. system covers all of the aspects fairly well, and I thought that throwing
  237. together a long doc file would just be a rehash.
  238.