1. set word wrap to ON to read this file properly.
________________________________________________________________________________
this program should not be distributed anywhere else than www.gtatools.com or
other gtanet sites such as http://www.gtagarage.com. if you distribute this
program
on any other website your server shall crash and burn in flames and your
girlfriend will leave you next evening if you don't always update the program
to latest version, please read the informations about distribution on
www.gtatools.com.
________________________________________________________________________________
GTA Garage Mod Manager 2.3C build: 070207
This program is only for PC version of Grand Theft Auto games.
Copyright 2005-2007 Delfi - Jernej L.
email: jernej@gtatools.com
always get latest and up-to-date copy of the program at http://www.gtatools.com
or http://www.gtagarage.com
this program is a fully featured car packager / installer / renderer (3D) and
helps creating custom cars.
program is freeware, you may NOT gain any money with using, redistributing,
copying, changing this file unless you have my permission!
the program comes with no warranty and the author is not responsible for
anything the program or his user do under any circumstances, if this is against
your local laws or you don't agree to this then you are not authorised to use
the program.
________________________________________________________________________________
Installation
________________________________________________________________________________
extract the archive files into your gta installation directory (gta3, vice city
or san andreas), this enables you to use the program with several games at once.
the ggmm.exe, gtainterface.dll and ggmm.txt should be IN exact same folder as
gta3.exe, gta-vc.exe or gta_sa.exe
after you install it, click the help "?" button on program and set file
association for .GGM files
important note !!
!!!!!!! only one program can control the file asociation at once !!!!!!!
program requirements:
- this program requires at least geforce3 class graphical card (but older may
still work)
- a decent graphical card with DXT/S3TC support for gta-vc and gta-sa
- GL_EXT_texture_env_combine driver extension for displaying reflection maps
correctly in opengl graphical driver
- gfx card should have at least 4 texture units for multitexturing
- one MB of disk space per installation
- windows 2000 or xp or 2003, win98 untested (may work, maybe not..)
- currently no testing was made on windows vista, if it doesn't work don't use
vista.
- should run under linux / wine
- reactos is not yet at stable enough version for ggmm to work ;)
________________________________________________________________________________

2. Changes
________________________________________________________________________________
Version 2.3C build: 070207:
- fixed installer drag&drop bug and wrong work in progress tab being shown by
default accidently
- fixed vice-city and gta3 wheel rendering
- fixed calculation of zoom level for models created with zmodeler
Version 2.3B build: 050207:
- fixed text parsing routines to handle tab characters properly.
Version 2.3 build: 200107:
- fixed search box.
Version 2.3 build: 200107:
- fixed: various internal bugs have been fixed which have not caused specific
large-scale troubles
- added: visually improved car list & find box to blend with interface
- added: when viewing models, it automaticly selects ideal zoom
- added: you can change heading of car's front wheels.
Version 2.1 build: 25030X:
- fixed: vicecity and gta3 wheels now again work properly
- fixed: program will no longer render additional objects under hirerarchy root,
only first object that it finds, this is also how gta does it.
- added: program now doesnt use 100% cpu usage, it will now only use so many cpu
cycles as it needs to.
- added: detects and warns about corrupt txd files
- added: file dialogs in manual car installer are now resizable (thanks to
Scuanor for noticing it)
Version 2.0 build: 11020X:
- added: shows cars in custom colors you wish - for car designers
- added: car view by default rotate and animate until used, this is done so that
people dont think that cars are just pictures ;) you can right click and click
animate to put it into animate mode at any time.
- added: + and - numpad keys now also control zoom (for those without mouse
wheel and notebook users)
Version 1.7 build: 270805:
- added: some work was done on internal data editor, but it is not availible in
this release.
- fixed: SA BMX now renders properly
- fixed: VC Flatbed now renders properly
- fixed: changed tractor and combine big wheel hack so now only tractor and
combine have big wheels
- fixed: carmods.dat issuse should be fixed altrough i was unable to reproduce
this error.
Version 1.5 build: 140805:
- added: additional handling lines like for helicopters and bikes are now
supported in GGMM packages and manual car installer
- added: hirerarchy items now have checkboxes which you can uncheck and ggmm
won't draw that object branch, this works with dummies too, also a note that
this won't work right always, sometimes special rules apply on how gta draws
things (like san andreas wheels) and so for some objects it might not work
- added: you can now control orientation of misc_a and misc_b objects

3. - added: you can now package weapons, but the packages don't contain weapon.dat
information
- added: you can make backups of weapons
- added: the program checks if it is installed properly, if not it gives you
hints on how to install it.
- added: if you on manual car installer enter colors data for car that has no
color information the color information will be ADDED to colors file.
- fixed: vicecity helicopters no longer have wheels on them
- fixed: vicecity bikes now have proper wheel sizes
- fixed: you can no longer "edit" text displayed when installing ggm mods
- fixed: if you left some data to the manual car installer empty the validation
mistakenly cleared some fields, now it doesn't do this anymore.
Version 1.4b (080805):
- added: option to show dummies (best viewed in wireframe mode because dummies
are always drawn solid)
- added: option to disable reflections completely (sometimes the chrome is too
shiny, and sometimes ATI cards couldn't handle it properly)
- fixed: solid faces no longer cut through transparent faces (and opposite). the
program now draws model in 2 passes, there could be still glitches if your car
happens to have transparent wheels..
- fixed: in gta3 some cars had a dummy named "steeringwheel_dummy" and GGMM
accidently drawn a wheel on the dummy because it thought it is a wheel dummy,
now it doesn't do that anymore.
Version 1.4a (070805):
- added: refreshes data after manual car installing
- added: propeller blades and bike wheels now also animate
- added: you can now do a little car "show-off" using object rotations in model
information window (open doors, etc..)
Version 1.4 (060805):
- added: new improved program look / skin by Tank
- added: manual car installer has a validate button, the configuration is also
validated when you click install button.
- added: in san andreas now shows chrome reflections (used by Linerunner, some
cars and some boats) (requires GL_EXT_texture_env_combine opengl extension to
look properly)
- added: in san andreas mode you can now view second uv map (may be little
glitchy) (requires GL_EXT_texture_env_combine opengl extension to look properly)
- added: shininess specular sphere-maps are now displayed (in san andreas) but
not in vice city yet (requires GL_EXT_texture_env_combine opengl extension to
look properly)
- fixed: zmodeler 1.x cars show their normals correctly now.
Version 1.3a (050805):
- added: icons to menus and hirerarchy viewer (blue things are dummies, silver
are geometry objects)
- added: model details window now shows amout of triangles and vertices rendered
- added: right clicking on car list now selects the car before showing popup
menu
- added: car popup menu has a item for instant backup creation for any car
- fixed: zmodeler2 dffs now load properly
- fixed: if san andreas wheel object was not named wheel or wheel2 then it was
not rendered, now the program uses object under wheel_rf_dummy for san andreas
wheels just like the game does.

4. Version 1.3 (040805):
- added: gta3 and vice city cars now show with wheels
- added: cars are shown shiny using normals from the cars themseles
- added: program can read gta-vc speca and san andreas reflection maps (altrough
i don't know how to use them properly so they would look like ingame)
- fixed: no more missing cars and wierd objects, cars are displayed the way they
should without need for reloading
- fixed: every time you reloaded the car list was filled with doubles, now it
doesn't do that anymore
- fixed: gta3 car rendering now works properly
- fixed: sometimes you could see thru cars where transparent objects were, now
in those cases the transparency is not displayed so the view is better altrough
this needs a proper object sorting fix
opposite of the features added & fixed this version of program is now actually
smaller than before!
Version 1.2 (030805):
- added: backup system, when you first time install a package the original car
will be packaged and put into CarBackups folder which will be created - note
that when using manual car installer no backups are made because program doesn't
know which car you are installing (because you can for example install data line
for landstalker, dff file for infernus and txd for tank..)
- added: carmods.dat file packaging support, packages and program are ofcourse
backwards compatible just that older versions will not know how to handle
carmods line and will skip that data when installing ggm files
- added: more safety checking when installing .ggm mods
- fixed: sometimes if you didn't enter IDE line into manual car installer the
san andreas game wasn't properly detected
Version 1.1 (020805):
- added: search box, while you type text the text the program automaticly
searches the list and selects first item that contains the searched text
- added: several checks for detecting if gta game is running in background which
may cause problems
- added: more checking when installing .ggm mods
- added: drag & drop on main window, you can drag & drop a ggm file into main
window to install it.
- fixed: window flickering while resizing has been eliminated
- fixed: cars with 4 colors in carcols.dat now show 3 colors correctly (prim,
sec, ter..), color 4 is never used afaik so i don't know how to use it
________________________________________________________________________________
Tips
________________________________________________________________________________
- you can specify coll file in manual car installer for san andreas too, if you
do that it will be merged with dff model, if dff already has a coll chunk it
will replace it.
- altrough main window is oddly-shaped it is resizable
- you can also view weapon models (no packaging availible yet)
- mods are packaged together with description / readme text
- the browser doesn't work yet but it will download and install mods one day
- the program works for gta3, vice city and san andreas
- the GGM files are already pretty well compressed and contain a readme.txt text

5. that is displayed when installing mods, so you shouldn't double compress the ggm
files to archieve better compression (rar might gain approx 10 kb) or to include
a readme file.
________________________________________________________________________________
Known problems
________________________________________________________________________________
- The mod browser doesn't work (yet)
- 3D renderer's background sometimes doesn't look nice when the window is
resized
- when resizing the window the model is not displayed until you drop the sizing
grip, this problem is not too serious but i hope to fix it one day.
- the model is sometimes not rendered right, just reload the model (may take
several times)
- no wheels are rendered in vice city and gta3 mode, you will see red boxes
instead.
________________________________________________________________________________
Credits
________________________________________________________________________________
The program was programmed in 2005 by Jernej L. (Delfi) for www.GTAGarage.com
my website is: http://www.gtatools.com'
Tech support: jernej@gtatools.com' + #13 +
Big Thanks to everyone that supports my work, especially these people:
Tank for the program''s design
Steve M. for his patience and help on dff format
Kcow for his DFF / TXD loader!
And big thanx to Fred for GTAGarage!!

6. that is displayed when installing mods, so you shouldn't double compress the ggm
files to archieve better compression (rar might gain approx 10 kb) or to include
a readme file.
________________________________________________________________________________
Known problems
________________________________________________________________________________
- The mod browser doesn't work (yet)
- 3D renderer's background sometimes doesn't look nice when the window is
resized
- when resizing the window the model is not displayed until you drop the sizing
grip, this problem is not too serious but i hope to fix it one day.
- the model is sometimes not rendered right, just reload the model (may take
several times)
- no wheels are rendered in vice city and gta3 mode, you will see red boxes
instead.
________________________________________________________________________________
Credits
________________________________________________________________________________
The program was programmed in 2005 by Jernej L. (Delfi) for www.GTAGarage.com
my website is: http://www.gtatools.com'
Tech support: jernej@gtatools.com' + #13 +
Big Thanks to everyone that supports my work, especially these people:
Tank for the program''s design
Steve M. for his patience and help on dff format
Kcow for his DFF / TXD loader!
And big thanx to Fred for GTAGarage!!