home *** CD-ROM | disk | FTP | other *** search
/ Multimedia Magazine 7 / Multimedia-No7-11-1995.iso / APPLICAT / EDUCATE / VPADDONS / VPUN220.ZIP / VPUNPACK.DOC next >
Text File  |  1994-11-13  |  10KB  |  218 lines
  1.  
  2. VPUNPACK - FAST result file unpack utility.   (c) 1993-94  Sysma Automatisering.
  3.  
  4.  
  5.  
  6. Disclaimer of Warranties
  7. ========================
  8.  
  9. The program is delivered to you as is. Although copyrighted,
  10. Sysma Automatisering shall not be liable for any damage whatsoever arising
  11. out of your use of this program, either in it's origional form or any altered
  12. form, even if you have been advised of the possibility of such damages.
  13.  
  14. Although distributed freely, this is copyrighted material. You are hereby
  15. granted the rights to use and/or modify the program for your personal use.
  16. You may (re)distribute this program or your own modifications, PROVIDED you
  17. distribute the complete set of origional files with your own modified ones
  18. and you distribute them without charging any money or any other form of
  19. compensation.
  20.  
  21.  
  22. History
  23. =======
  24.  
  25. 12/11/94   Version 2.20   Added support for VPHOST's message transponder.
  26. 15/10/94   Version 2.10   Added two DPMI versions, VPUNPCKX.EXE is the 16
  27.                           bits DPMI version, VPUNPK32 is the 32 bits DPMI
  28.                           version. Protected mode versions have the limit
  29.                           on received messages raised to 4096.
  30. 16/01/94   Version 2.00   Improvements made to version 2.00 of VPUTIL are
  31.                           now also in VPUNPACK. Version number raised to
  32.                           keep in sync with VPUTIL.
  33. 18/12/93   Version 1.01   Raised the limit of received messages from 200 to
  34.                           500, to be able to proces the results when
  35.                           Ragnarok has generated an Armageddon.
  36. 05/11/93   Version 1.0    First public release.
  37.  
  38.  
  39. Introduction
  40. ============
  41.  
  42. This utility is designed to support and enhance the host part of the game
  43. VGA Planets versions 3.0 only (ie. Planets.Exe). VGA Planets is a strategic
  44. space war/economy simulation game for upto eleven players. The unique feature
  45. of the game is that it plays the turns off-line. This means that there is a
  46. game server (or Host) somewhere where the entire game universe exists. The
  47. game server executes the commands the players provide each game turn and
  48. provides the results, tailored to every player.
  49.  
  50. Each player gets the results meant for him and uses the game client program
  51. (Planets.Exe) to view the results of the previous set of commands and to issue
  52. new ones. Because each player gets only results from the host concerning his
  53. own ships and planets, it is not possible to see enemy ships or planets when
  54. the game rules don't permit this.
  55.  
  56. Build into the game is an E-mail facility, which enables the possibility to
  57. send messages to other players. This E-mail facility is also used by the
  58. automated host program to report information back to you regarding the previous
  59. issued commands. You can use this E-mail facility just as you like. A good
  60. purpose would be to perform diplomacy with it. Messages you send to a player X
  61. don't arrive by player Y if you so choose.
  62.  
  63. At certain planets there are starbases in orbit. These starbases are very
  64. important, as they act as your space ship factory and a space ship repair/refit
  65. location. At every starbase a set of four technology levels are maintained. The
  66. levels are for space ship hulls (ie. the frame to build a space ship),
  67. transwarp drive engines, beam weapons and photon torpedoes. The higher a
  68. techonoly level, the more powerfull the parts concerned become.
  69.  
  70.  
  71. Purpose
  72. =======
  73.  
  74. The sole purpose is to be a FAST replacement for the VGA Planets UNPACK
  75. utility. This program is up to 20 times as fast as the origional UNPACK utility.
  76.  
  77.  
  78. DPMI protected mode versions
  79. ============================
  80.  
  81. Usage of the protected mode versions is identical to the real mode VPUNPACK
  82. command, described in the next section. However, there are several additional
  83. points to keep in mind.
  84.  
  85. VPUNPCKX is the 16 bits DPMI version, and requires at least a 286 machine
  86. with 2 MB of RAM installed. It calls and uses RTM.EXE as it's DPMI service
  87. provider. RTM detects and uses an already present DPMI server (such as HIMEM
  88. or QEMM), but if a server is not yet installed, it installs it's own server
  89. DPMI16BI.OVL, which must be locateable in the current directory, or via the
  90. PATH.
  91.  
  92. VPUNPK32 is the 32 bits DPMI version, and requires at least a 386 machine
  93. with 2 MB of RAM installed. It calls and uses 32RTM.EXE as it's DPMI service
  94. provider. 32RTM detects and uses an already present DPMI server, but if a
  95. server is not yet installed, it installs it's own server DPMI32VM.OVL, which
  96. must be locateable in the current directory, or via the PATH.
  97.  
  98. In addition, if you wish to spawn the 32 bits version from the MS Windows 3.x
  99. environment, be sure to add the following line to your SYSTEM.INI file, in
  100. the [386Enh] section:
  101.  
  102. device=d:\your\path\WINDPMI.386
  103.  
  104.  
  105. The message transponder
  106. =======================
  107.  
  108. As of version 2.00 of VPHOST, a message transponder is included. The purpose
  109. of this transponder is to send any binary information from the host to the
  110. players, or vice versa. Typically this transponder is used to pass information
  111. from the host the the players that is not normally included in the result
  112. file format currently in use.
  113.  
  114. Players may receive data via the transponder in any of three ways. The host
  115. may have instructed VPHOST to send information manually, the player itself
  116. may have requested information, or VPHOST may have initiated the transponder
  117. itself based upon some internal processing condition.
  118.  
  119. The transponder sends the information in specially formatted messages, which
  120. are not readable directly. The unpack result file routine of VPUTIL (version
  121. 2.50 upwards) and VPUNPACK (version 2.20 upwards) are capable of both
  122. recognizing this special format and processing the messages. This means that
  123. you normally would never see these messages, except for the results they
  124. produce on your game data.
  125.  
  126. However, there may be occasions that you DO see these messages. If this
  127. happens, one of two things may have gone wrong. The first one is that you
  128. used an older version of either VPUNPACK or VPUTIL. At the bottom of each
  129. transponder message is the lowest version needed for either program that is
  130. capable of processing that particular message. Check it against your current
  131. versions and upgrade to the listed versions if yours are out of date.
  132.  
  133. If, on the other hand, your current versions are up to date, the message
  134. could not be processed for integrity reasons. Some transponder messages need
  135. access to VGA PLANETS's global data files for modifications. The transponder
  136. processor refuses to process any of these messages when the global data
  137. files are not in the same directory as your game data itself. When it is
  138. present in your game directory, the processor automatically assumes that
  139. these are copies of the origionals and that it is safe to make changes.
  140.  
  141. Note that currently it is recommended to have your global data files copied
  142. in your game directory, since different games may use different global
  143. data files, ie. different ship specs, different star charts, etc. VPUTIL and
  144. VPUNPACK automatically recognize and use global data files whenever they
  145. are found in the game directory. However, ALL of the global data files need
  146. to be present in order to enable this feature.
  147.  
  148.  
  149. Usage
  150. =====
  151.  
  152. The usage is identical to the origional UNPACK utility. At the command line
  153. an optional directory path may be specified. If no path is specified, the
  154. current directory is assumed. Instead of the standard UNPACK utility, the
  155. result (.RST) files will NOT be deleted by this program. They are left alone.
  156.  
  157. As an enhanced feature this VPUNPACK utility will accept multiple directory
  158. paths and will process them one at a time, until either all directories have
  159. been processed, or an error has occured, whichever is first.
  160.  
  161. Note that in order for this utility to work, ALL the global data files of
  162. VGA Planets must be present in the specified game directories, the current
  163. directory, or the directory where VPUNPACK is located, in that order.
  164. This is necessary since VPUNPACK will use these data files to produce
  165. meaningfull names during unpacking.
  166.  
  167. This utility will put the shareware signature in the encrypted data, if you
  168. unpack to a directory which has no signature yet. A signature is automatically
  169. created whenever you leave PLANETS. Changing anything or not is not relevant
  170. in this case.
  171.  
  172. This is nothing to worry about when you are a registered user, since it is
  173. allowed to switch between registered and shareware versions of PLANETS,
  174. provided you did not change anything with PLANETS or any other tool to your
  175. unpacked data. So if you are a registered user, simply start with your
  176. registered copy and all will be fine.
  177.  
  178. If, however, a registered signature was already present, it will be preserved
  179. by this utility. This means you can directly change your data with your
  180. favourite tool without running PLANETS at all and still be able to use
  181. MAKETURN to create a turn file with your registered signature inside it.
  182.  
  183. Note, however, that this is a special feature of VPUNPACK and not a standard
  184. feature of the origional UNPACK utility. The UNPACK utility does not update
  185. some of the essential encrypted data, needed by MAKETURN to function properly.
  186. If you use the standard UNPACK utility, you MUST run PLANETS before running
  187. MAKETURN, since only PLANETS in the standard VGA Planets 3.0 package will
  188. create this data.
  189.  
  190.  
  191. Comments
  192. ========
  193.  
  194. When you have comments or find bugs, please do not hesitate to contact us.
  195. Also, if you have ideas on how to expand the program or have suggestions for
  196. new commands or options, please contact us.
  197.  
  198.  
  199.  
  200. Our email address is:
  201.  
  202. FIDO:      'Jan Peter Dijkstra' at 2:283/323.12
  203. INTERNET:  jan-peter@saluton.xs4all.nl
  204.            j.p.dijkstra@sysma6.cnt.antenna.nl
  205.  
  206.  
  207. We can also be contacted by mail. Our mail address is:
  208.  
  209. Sysma Automatisering
  210. tav. J.P. Dijkstra
  211. Fazantstraat 169
  212. 7523 DP  Enschede
  213. The Netherlands
  214.  
  215. Phone: +31 53 337410
  216. Fax:   +31 53 311090
  217.  
  218.