_______________________________________________________________________
 __  ___             __  __     ___        __  ___               __  _ 
|     |   /\   |\/| |  | | \     |  |\  | |     |   /\  |   |   |   | \
| _   |  |--|  |  | |  | |  |    |  | \ | |__   |  |--| |   |   |-  |-/
|__|  |  |  |  |  | |__| |__|   _|_ |  \| ___|  |  |  | |__ |__ |__ | \
------------------------------------------------------------------------

 ----------------------------------------
| Program Name:      GTA Mod Installer   |
 ----------------------------------------
| Program Version:   v2.2                |
 ----------------------------------------
| Creator:           cpmusick            |
 ----------------------------------------
| Creator's Email:   cpmusick@gta3hq.com |
 ----------------------------------------
| Official Website:  www.gta3hq.com      |
 ----------------------------------------



 ----------------------------------------
|   What the Purpose of This Program?    |
 ----------------------------------------

This program was created so that it would be a whole lot easier to
install custom vehicles and mods into both GTA3 and GTA Vice City.



 ----------------------------------------
|         What Are the Features?         |
 ----------------------------------------

---Install Mods (or Vehicles) Using Script Files--

-If a mod (or vehicle) comes with a script file(s), then the mod 
 (or vehicle) will be installed automatically, according to the 
 instructions in the script file.

-Can have multiple script files, meaning if the mod can be installed
 to GTA3 and Vice City, there's a separate script for each game.

-Can have uninstall scripts as well, which are used for automatically
 uninstalling the mod\vehicle.


--Install Vehicles (that don't have a script file)--

-Ability to automatically search for and install the DFF and TXD files
 for the custom vehicle.

-Automatically search for and insert any handling.cfg, carcols.dat, and
 default.ide info in the readme for that car.

-Automatically detects which vehicle will be replaced and inserts the
 new DFF and TXD files for the custom vehicle automatically.

-Allow the installation of both GTA3 and GTA Vice City custom vehicles
 in one simple and easy to use program.

-Edits all necessary files automatically, including the handling.cfg,
 carcols.dat, default.ide, and IMG files.

-Automatically detect the game's installation directory (most of the 
 time).

-Automatically inserts the original handling.cfg, default.ide, and carcols.dat
 info if either of those lines were not provided with the custom vehicle.

-ZIP file support. Just select the ZIP file you downloaded for the car and it
 get extracted and installed automatically.
-------------------------------------------------------------------------

Version 2.2 Changes
-Fixed bugs installing Vice City cars, as well as inserting original
 handling lines for both GTA and Vice City.

Version 2.1 Changes
-Fixed some bugs when using multiple script files.

Version 2.0 Changes
-Added script support, which allows mods to be installed or uninstalled by following
 the directions in the script file(s).
-It now sets all necessary files to NOT be Read-Only. This helps prevent problems
 when installing vehicles\mods.
-Added support for inserting cutom-made colors to be added to the carcols.dat color 
 list (if the vehicle comes with that info).
-Improved error detection for the handling.cfg, default.ide, and carcols.dat lines.

Version 1.2 Changes
-Big bug fixes for some of the Vice City vehicle installations (due to some cars having
 a different name in the default.ide than the handling.cfg).
-Zip file support. Automatically extracts the selected ZIP and installs the vehicle.
-Automatically inserts original default.ide, handling.cfg, and carcols.dat lines if
 either of them aren't provided with the custom vehicle. This helps prevent major errors.
-Better vehicle database management and detection.
-Install stops if the txd.img file is not found (for GTA3 cars). This keeps the car's
 TXD file from being installed wrong.
-When finished, it tells which car was replaced.
-Improved error detection even more.


Version 1.1 Changes
 -DFF and TXD files are detected automatically and more accurately.
 -No longer have to choose which car it replaces. It now detects that 
  automatically.
 -Much Better error detection. If an error is found, it tells you why and 
  how to fix it.
 -Better handling.cfg, default.ide, and carcols.dat detection.



 ----------------------------------------
|            How Do I Use IT?            |
 ----------------------------------------
It's pretty self-explainatory. Just read the information on each
screen, and it will be very simple to use. Some mods\vehicles may
come with script files (installscript_gta3\vc.txt). If so, then 
you can choose the "Script" option to automatically install that 
mod\vehicle, which will follow instructions provided in the script.

If the handling.cfg, carcols.dat,or default.ide info is not detected, then 
copy and paste it in the box manually. If one of those lines were not provided 
with the custom vehicle,then you can leave that box blank and the original lines 
for the car being replaced will automatically be used instead.



 ----------------------------------------
|    What Will Be In Future Versions?    |
 ----------------------------------------
I plan on giving it the ability to let you choose which car to replace,
and have the program automatically rename everything accordingly. However,
this is not yet available.

I also plan on making it support backing up any files that are edited
or replaced.

I'll also try to add support for automatically converting cars from
GTA3 to Vice City to be 100% compatible.

If there's any bugs, those will be fixed as well.



 ----------------------------------------
|      Contact Info and Bug Reports      |
 ----------------------------------------
If you would like to contact me (cpmusick) for any reason, send me an
email at cpmusick@gta3hq.com and I'll respond as soon as I'm able to.

If you have any suggestions, find any bugs, or have any problems with
GTA Mod Installer, then please email explaining the situation.


Thanks for using this program! Have fun!
