                  MM2 Game Loader 2007.9 by Maxoff
                            2007.09.09

This program was created to solve problems with police cars and shared files like
new materials once forever. You can forget about vehtypes.csv. You don't need 
to update addon_vehtypes.ar or use tools like MM2 Addonvehtypes Builder. MM2GL 
can do much more and much easier. It works also as mod manager and allows to 
turn mods on/off.

-----------------------------------------------------------------
        How to use MM2GL - end-user instruction
-----------------------------------------------------------------
Just save it on the disk and run. It asks you for game directory. You can also define
EXE file name in MM2GameLoader.cfg if you don't use Midtown2.exe (it's default value).

When you run MM2GL the program scans game directory and checks available files. It
searchs for .ar and .ar_off files and displays them in the list. You can turn on/off selected
mod. The program informs also about mod conflicts so it should help you to resolve
many problems. When you finish mod managing, just click "Run the game".

----------------------------------------------------------------
                                Shortcuts
----------------------------------------------------------------
Space - turn mod on/off
F2 - define friendly name for mod

-------------------------------------------------------
        How install police car in the game
-------------------------------------------------------
1. Run MM2GL
2. Drag and drop AR file to the mods list - the program
will copy AR and XML file (if exists) to the game directory

----------------------------------------------------------------
       How to install city with additional materials
----------------------------------------------------------------
1. Run MM2GL
2. Drag and drop AR file to the mods list - the program
will copy AR and XML file (if exists) to the game directory

----------------------------------------------------------------
     How to define command file for Midtown2.exe
----------------------------------------------------------------
Open MM2GameLoader.cfg and find:
GameEXE=Midtown2.exe

Now you can add parameters to it:
GameEXE=Midtown2.exe -nomovie

----------------------------------
        How MM2GL works
----------------------------------
It scans game directory in three stepes:
1. check AR files and search for police cars 
(in deep scan mode it searchs also for other conflicts)
2. check *.xml files and merge all definitions

In the result, it creates !!!_share.ar which contains updated:
aud/cardata/player/default_impacts.csv - impact sounds
aud/cardata/shared/vehtypes.csv - police cars definition
city/materials.csv - materials definition
city/materials.mtl - materials definition

The program creates also MM22GameLoader.log which contains additional
information about program work. Please check it if you want to know
which materials and other shared files are overwritten.

----------------------------------
        Scaning modes
----------------------------------
In normal scan program searchs only for police cars and materials.

In deep scan program searchs duplicated entries in all AR files. If you
have (for example) sf.inst in two (or more) AR files, MM2GL will inform you
about it.

----------------------------------------------------------------
        How to make grass in own city
----------------------------------------------------------------
You use for example my_city_grass.tga for grass 
in your city and you want it acts as grass in game. 

It's easy. Just pack your city to city_my_city.ar, 
then create text file city_my_city.xml (in notepad)
which contains:

  <info name="My city">
  it's my first city
  </info>
  <add file="city/materials.csv>
  my_cty_grass,grass
  </csv>

Please check sample XML file for details.

ATTENTION!!! Materials names are case sensitive, so
please write it exacly the same as they are written
in .PSDL or .PKG file.

----------------------------------------------------------------
                          Shared base files
----------------------------------------------------------------
All MM2GL's base files are saved in BASE dir. You
can find there:
- aud/cardata/player/default_impacts.csv
- aud/cardata/shared/vehtypes.csv
- city/materials.csv
- city/materials.mtl
They came from standard mm2 files. If you want to
edit e.g. materials in specific way, you can change
base files - but it's not recommended.

Maxoff
HQTM-Team
www.hqtm-team.gamehorizons.net