home *** CD-ROM | disk | FTP | other *** search
/ Unprotect 6 / Unprotect-6.0.iso / update / tanks130 / obreader.txt < prev    next >
Encoding:
Text File  |  1994-06-17  |  6.9 KB  |  145 lines
  1. !!!!!!!!!!! WARNING WARNING WARNING WARNING WARNING !!!!!!!!!!!
  2. !                                                             !
  3. !    The OBREADER utility was designed for development use,   !
  4. ! and was not originally intended for use by end users.  Since!
  5. ! players have requested it, I've made it available.          !
  6. !                                                             !
  7. !    For the record:                                          !
  8. !                                                             !
  9. !    1) This is not an SSI product.                           !
  10. !                                                             !
  11. !    2) It is provided free of charge, and may be freely      !
  12. ! distributed - as long as this file is included.             !
  13. !                                                             !
  14. !     3) I will be available for questions through GEnie, but !
  15. ! I make no promises that this package will be supported in   !
  16. ! any way by myself or SSI.                                   !
  17. !                                                             !
  18. !     4) SSI and I assume no liability for any damages caused !
  19. ! by use of this package.                                     !
  20. !                                                             !
  21. !     5) SSI customer service will not accept questions       !
  22. ! regarding OBREADER.                                         !
  23. !                                                             !
  24. !     6) If you encounter program difficulties while using a  !
  25. ! database modified by this utility, you should assume that   !
  26. ! the problem is caused by the modified database and restore  !
  27. ! the original database before contacting SSI for help.       !
  28. !                                                             !
  29. !     I strongly suggest that you make a second copy of your  !
  30. ! TANKS directory and use that for your experimentation with  !
  31. ! the database.  If you don't do this, and you encounter      !
  32. ! difficulties, you'll have to reinstall from the disks that  !
  33. ! came from the game.                                         !
  34. !                                                             !
  35. !!!!!!!!!!! WARNING WARNING WARNING WARNING WARNING !!!!!!!!!!!
  36.  
  37.      As promised, this is the OBREADER database compiler
  38. which was used to create the database for TANKS!  In
  39. addition to this file, you should have OBREADER.EXE and
  40. FISTDATA.ASC.  OBREADER.EXE is a command line utility that
  41. reads the FISTDATA.ASC file and creates the various data
  42. files used by TANKS!  FISTDATA.ASC is a standard text file,
  43. which can be modified using any ASCII text editor.
  44.  
  45.      To use: Put this package in your TANKS directory.  It
  46. expects to find certain files in fixed locations, and will
  47. fail if run outside of a TANKS directory.  Using a text
  48. editor, make your modifications to the FISTDATA.ASC file and
  49. save it.  From the command line, type "OBREADER" and press
  50. return.  Game data files DATA\H_UNITS.DAT and
  51. DATA\WEAPONS.DAT will be modified, and two new files will be
  52. created: DUMP.ASC and NUMBERS.ASC.  Because of these files,
  53. you must have at least 100K of free disk space to run
  54. OBREADER.
  55.  
  56. NUMBERS.ASC includes information regarding the number of
  57. units and silhouettes indexed by the modified database.  You
  58. should examine each force listing in this file for the 
  59. following:
  60.  
  61. WWII Germans can have a maximum of 53 silhouettes.
  62. All others can have a maximum of 35 silhouettes.
  63. All forces can have a maximum of 66 units.
  64.  
  65. If you exceed any of these maxima, you will encounter
  66. difficulties in using your modified database.  Please
  67. eliminate enough units to bring your numbers within the
  68. limits.
  69.  
  70. DUMP.ASC includes a complete listing of all units in your
  71. new database.  You should load this file into a text editor
  72. and search for the words "warning", "error" or "not found".
  73. If you encounter any of these, there is something flakey in
  74. the database.  In any case, it is wise to thoroughly examine
  75. DUMP.ASC for any indications of problems before using your
  76. modified database in the game.  The phrase "not used" is OK
  77. and doesn't indicate a particular problem.
  78.  
  79. Database modification:
  80.  
  81.      Data organization is described in the comment lines
  82. (set off by "!" symbols) in FISTDATA.ASC.
  83.  
  84.      Please take note of any maxima specified in the
  85. comments and do not exceed them.
  86.  
  87.      To include a new unit in a force, insert it at the end
  88. of the unit list for that force, before the "@" symbol.  Do
  89. not delete or add any "@" symbols.  Avoid spaces except in
  90. names.  Don't insert new lines unless you are adding units
  91. to a force.
  92.  
  93.      If you want new units in your modified database to be
  94. included in random scenarios, stick with the existing name
  95. conventions.  The random scenario generator specifically
  96. looks at unit names when picking units, and it won't pick
  97. anything it can't recognize.  So you should stick to names
  98. like "Tank Plt", "Gun Bty", etc.  A unit named "Tank Bn",
  99. for example, would not be picked by the random scenario
  100. generator.
  101.  
  102. The number of weapons and equipment types in the game are
  103. fixed:
  104.  
  105.      To add a weapon, an old weapon must be deleted.  In
  106. addition, any equipment types that mount that weapon must be 
  107. deleted or changed so that they no longer mount that weapon.  
  108. I suggest that if you decide to add/delete weapons, you
  109. should be careful to delete only weapons used in one
  110. historical period - preferably 1918.
  111.  
  112.      To add an equipment type, an old equipment type must be 
  113. deleted.  In addition, any units that include the old 
  114. equipment type must be deleted. As with weapons, you should 
  115. probably limit your deleted equipment types to one period - 
  116. preferably 1918.
  117.  
  118.      If you make changes to silhouettes assignments, you can
  119. change the silhouettes in the GRAPHICS\ICONS??.LBM files.  
  120. You will need to use a paint program (such as Deluxe Paint 
  121. 2e) that is capable of handling LBM files.  When you save 
  122. your modified LBM file, make sure that the stencil is OFF! 
  123. (See your paint program documentation.)  Silhouettes are 
  124. arranged from top to bottom, left to right, and in order of 
  125. file number.  For example, silhouette 143 is ninth from the
  126. top, fourth from the left, in files GRAPHICS\ICONS?2.LBM.
  127.  
  128.      If you add / delete any weapons or equipment types, any
  129. old scenarios which use those systems will cause problems.  
  130. And any new scenarios you create with your modified database 
  131. will be unplayable on a computer using another database. Same
  132. goes if you delete any units.  That's why I recommend making
  133. all of your adds / deletes to systems belonging to one
  134. isolated historical period or force.  Adding units is safe, 
  135. as long as you stay inside the maxima.  Modifying information 
  136. within individual units, systems, or weapons is also safe.
  137.  
  138.                 Norm Koger 2.0
  139.  
  140.                 EMAIL addresses-
  141.                         GEnie: n.koger
  142.                         Internet: n.koger@genie.geis.com
  143.                         (_NO_ "attached files" please!)
  144.  
  145.