home *** CD-ROM | disk | FTP | other *** search
/ GameStar Special 2004 March / GSSH0304CD2.iso / GTA3 / ModInstaller / Readme.txt < prev    next >
Text File  |  2004-01-28  |  9KB  |  212 lines
  1. _______________________________________________________________________
  2.  __  ___             __  __     ___        __  ___               __  _ 
  3. |     |   /\   |\/| |  | | \     |  |\  | |     |   /\  |   |   |   | \
  4. | _   |  |--|  |  | |  | |  |    |  | \ | |__   |  |--| |   |   |-  |-/
  5. |__|  |  |  |  |  | |__| |__|   _|_ |  \| ___|  |  |  | |__ |__ |__ | \
  6. ------------------------------------------------------------------------
  7.  
  8.  ----------------------------------------
  9. | Program Name:      GTA Mod Installer   |
  10.  ----------------------------------------
  11. | Program Version:   v4.1                |
  12.  ----------------------------------------
  13. | Creator:           cpmusick            |
  14.  ----------------------------------------
  15. | Creator's Email:   cpmusick@gta3hq.com |
  16.  ----------------------------------------
  17. | URL: www.gta3hq.com  www.gtavicehq.com |
  18.  ----------------------------------------
  19.  
  20.  
  21.  
  22.  ----------------------------------------
  23. |   What the Purpose of This Program?    |
  24.  ----------------------------------------
  25.  
  26. This program was created so that it would be a whole lot easier to
  27. install custom vehicles and mods into both GTA3 and GTA Vice City.
  28.  
  29.  
  30.  
  31.  ----------------------------------------
  32. |         What Are the Features?         |
  33.  ----------------------------------------
  34.  
  35. ---Install Mods Using Script Files--
  36.  
  37. -If a mod comes with a script file(s), then the mod will be installed
  38.  automatically, according to the instructions in the script file.
  39.  
  40. -Can have multiple script files, meaning if the mod can be installed
  41.  to GTA3 and Vice City, there's a separate script for each game.
  42.  
  43. -Can have uninstall scripts as well, which are used for automatically
  44.  uninstalling the mod\vehicle.
  45.  
  46. -Ability to backup all files that are modified by a mod\vehicle (optional). You 
  47.  can also reinstall those files by using the mod installer and selecting 
  48.  the backup dir. This is possible because the mod installer generates a script 
  49.  for the backed up files.
  50.  
  51. -----Install Vehicles-----
  52.  
  53. -Ability to automatically search for and install the DFF and TXD files
  54.  for the custom vehicle.
  55.  
  56. -Automatically search for and insert any handling.cfg, carcols.dat, and
  57.  default.ide info in the readme for that car.
  58.  
  59. -Allows the user to choose which car they want to replace. All files and 
  60.  necessary handling lines will be renamed and adjusted accordingly.
  61.  
  62. -Can automatically convert GTA3 cars to Vice City and Vice City cars 
  63.  to GTA3, including all DFF\TXD files as well as the necessary handling lines.
  64.  This is all automatic, so no input is required from the user.
  65.  
  66. -Allow the installation of both GTA3 and GTA Vice City custom vehicles
  67.  in one simple and easy to use program.
  68.  
  69. -Edits all necessary files automatically, including the handling.cfg,
  70.  carcols.dat, default.ide, and IMG files.
  71.  
  72. -Automatically detect the game's installation directory.
  73.  
  74. -Automatically uses the original handling.cfg, default.ide, and carcols.dat
  75.  info if either of those lines were not provided with the custom vehicle.
  76.  
  77. -ZIP and RAR file support. Just select the ZIP or RAR file you downloaded for 
  78.  the car and it gets extracted and installed automatically.
  79.  
  80. -Automatic DMagic1 Wheel Mod detection. If the mod is not installed, then the
  81.  user is told where to download it.
  82.  
  83. -------------------------------------------------------------------------
  84.  
  85. Version 4.1 Changes
  86. -Automatic DMagic1 Wheel Mod detection. If the mod is not installed and a vehicle
  87.  requires the mod, it then tells the user where to download it.
  88. -Fixed the problem with the game freezing during loading when installing some vehicles,
  89.  which means better handling.cfg, default.ide, and carcols.dat line inserting.
  90. -Files no longer have to be in the same directory as the script to be installed.
  91. -Physics line validator.
  92. -Ignores "comment" lines in text\config files, which begin with "#" or ";"
  93. -Fixed RAR support for mods with script files.
  94. -Better backup script generating.
  95. -Other various improvements, bug fixes, and changes.
  96. -Features in Scripter v2.0:
  97.     -Much better design and more user-friendly.
  98.     -Ability to use a  "virtual directory", which will put all the mod's files
  99.      (and script) there, so that they can be zipped easily all from one place.
  100.     -Better error detecting.
  101.     -Other miscellaneous improvements.
  102.  
  103. Version 4.0 Changes
  104. -Ability to choose which car to replace.
  105. -Ability to automatically detect and convert GTA3 cars to Vice City and Vice City cars to GTA3.
  106. -Added support for RAR files.
  107. -Added automatic update feature.
  108. -New and better method for default.ide, handling.cfg, and carcols.dat line detecting, which is about 99% accurate.
  109. -Fixed bug with "Invalid Game Path" when it's actually valid.
  110. -Fixed problem with cars replacing the Greenwood and Line Runner.
  111. -Fixed problem with cars not changing for some people (making the necessary files to not be read-only).
  112. -Fixed bug with it not remembering the Vice City game directory.
  113. -One-step installing when restoring a vehicle that was previously backed up.
  114. -Other miscellaneous bug fixes and improvements.
  115.  
  116. Version 3.0 Changes
  117. -Ability to backup all files that are modified by a mod (optional). You can also reinstall those files 
  118. by using the mod installer and selecting the backup dir. This is possible because the mod 
  119. installer generates a script for the backed up files.
  120. -Better directory validation
  121. -Ability to display the mod's name (if specified in script)
  122. -Ability to display a text file after installing any mod (if the creator specifies one in the script)
  123. -Improved\Fixed a few other things as well
  124. -Features in scripter v1.1:
  125.     -Fixed problem with the 100 character limit.
  126.     -Added ablility to specify a name for the mod.
  127.     -Added ability to specify a text file to be shown after user installs the mod.
  128.  
  129. Version 2.2 Changes
  130. -Fixed bugs installing Vice City cars, as well as inserting original
  131.  handling lines for both GTA and Vice City.
  132.  
  133. Version 2.1 Changes
  134. -Fixed some bugs when using multiple script files.
  135.  
  136. Version 2.0 Changes
  137. -Added script support, which allows mods to be installed or uninstalled by following
  138.  the directions in the script file(s).
  139. -It now sets all necessary files to NOT be Read-Only. This helps prevent problems
  140.  when installing vehicles\mods.
  141. -Added support for inserting cutom-made colors to be added to the carcols.dat color 
  142.  list (if the vehicle comes with that info).
  143. -Improved error detection for the handling.cfg, default.ide, and carcols.dat lines.
  144.  
  145. Version 1.2 Changes
  146. -Big bug fixes for some of the Vice City vehicle installations (due to some cars having
  147.  a different name in the default.ide than the handling.cfg).
  148. -Zip file support. Automatically extracts the selected ZIP and installs the vehicle.
  149. -Automatically inserts original default.ide, handling.cfg, and carcols.dat lines if
  150.  either of them aren't provided with the custom vehicle. This helps prevent major errors.
  151. -Better vehicle database management and detection.
  152. -Install stops if the txd.img file is not found (for GTA3 cars). This keeps the car's
  153.  TXD file from being installed wrong.
  154. -When finished, it tells which car was replaced.
  155. -Improved error detection even more.
  156.  
  157. Version 1.1 Changes
  158.  -DFF and TXD files are detected automatically and more accurately.
  159.  -No longer have to choose which car it replaces. It now detects that 
  160.   automatically.
  161.  -Much Better error detection. If an error is found, it tells you why and 
  162.   how to fix it.
  163.  -Better handling.cfg, default.ide, and carcols.dat detection.
  164.  
  165.  
  166.  
  167.  ----------------------------------------
  168. |            How Do I Use IT?            |
  169.  ----------------------------------------
  170. It's pretty self-explainatory. Just read the information on each
  171. screen, and it will be very simple to use. Some mods may
  172. come with script files (installscript***.txt). If so, then 
  173. you can choose the "Script" option to automatically install that 
  174. mod\vehicle, which will use the instructions provided in the script.
  175.  
  176.  
  177.  
  178.  ----------------------------------------
  179. |    What Will Be In Future Versions?    |
  180.  ----------------------------------------
  181.  
  182. If there's any bugs, those will be fixed.
  183. Nothing else is planned for now.
  184.  
  185.  
  186.  
  187.  ----------------------------------------
  188. |      Contact Info and Bug Reports      |
  189.  ----------------------------------------
  190. If you would like to contact me (cpmusick) for any reason, send me an
  191. email at cpmusick@gta3hq.com and I'll respond as soon as I'm able to.
  192.  
  193. If you have any suggestions, find any bugs, or have any problems with
  194. GTA Mod Installer, then please email me explaining the situation. If 
  195. you receive an error message, then please include it in the email.
  196.  
  197.  
  198.  ----------------------------------------
  199. |            Legal Information           |
  200.  ----------------------------------------
  201. This program is to not be used\modified\distributed in an illegal form. 
  202. This includes modifying it, releasing it under another name or anything 
  203. else that involves theft. This especially applies for GTA3.net!  :)
  204.  
  205. I don't mind if you host it on any website, just as long as you give me 
  206. (cpmusick) the proper credit for making this program.
  207.  
  208.  
  209.  
  210.  
  211.  
  212. Thanks, and enjoy GTA Mod Installer!