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 prog
ram
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 he
lps creating custom cars.
program is freeware, you may NOT gain any money with using, redistributing, copy
ing, changing this file unless you have my permission!
the program comes with no warranty and the author is not responsible for anythin
g the program or his user do under any circumstances, if this is against your lo
cal laws or you don't agree to this then you are not authorised to use the progr
am.
________________________________________________________________________________
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 gt
a3.exe, gta-vc.exe or gta_sa.exe
after you install it, click the help "?" button on program and set file associat
ion 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 st
ill 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 cor
rectly 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 v
ista.
- should run under linux / wine
- reactos is not yet at stable enough version for ggmm to work ;)
________________________________________________________________________________
Changes
________________________________________________________________________________
Version 2.3C build: 070207:
- fixed installer drag&drop bug and wrong work in progress tab being shown by de
fault 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 la
rge-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 Scuan
or 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 whee
l 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 comb
ine have big wheels
- fixed: carmods.dat issuse should be fixed altrough i was unable to reproduce t
his error.
Version 1.5 build: 140805:
- added: additional handling lines like for helicopters and bikes are now suppor
ted 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 w
on't work right always, sometimes special rules apply on how gta draws things (l
ike 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
- 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 hin
ts on how to install it.
- added: if you on manual car installer enter colors data for car that has no co
lor 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 a
re always drawn solid)
- added: option to disable reflections completely (sometimes the chrome is too s
hiny, 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 acci
dently 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 v
alidated when you click install button.
- added: in san andreas now shows chrome reflections (used by Linerunner, some c
ars and some boats) (requires GL_EXT_texture_env_combine opengl extension to loo
k properly)
- added: in san andreas mode you can now view second uv map (may be little glitc
hy) (requires GL_EXT_texture_env_combine opengl extension to look properly)
- added: shininess specular sphere-maps are now displayed (in san andreas) but n
ot in vice city yet (requires GL_EXT_texture_env_combine opengl extension to loo
k 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 a
re 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 men
u
- 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 n
ot rendered, now the program uses object under wheel_rf_dummy for san andreas wh
eels just like the game does.

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 do
esn't do that anymore
- fixed: gta3 car rendering now works properly
- fixed: sometimes you could see thru cars where transparent objects were, now i
n those cases the transparency is not displayed so the view is better altrough t
his needs a proper object sorting fix
opposite of the features added & fixed this version of program is now actually s
maller than before!

Version 1.2 (030805):

- added: backup system, when you first time install a package the original car w
ill 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 kno
w which car you are installing (because you can for example install data line fo
r landstalker, dff file for infernus and txd for tank..)
- added: carmods.dat file packaging support, packages and program are ofcourse b
ackwards 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 sa
n andreas game wasn't properly detected

Version 1.1 (020805):

- added: search box, while you type text the text the program automaticly search
es 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 wi
ndow 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, se
c, 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 wil
l 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
that is displayed when installing mods, so you shouldn't double compress the gg
m files to archieve better compression (rar might gain approx 10 kb) or to inclu
de 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 resize
d
- 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 sev
eral times)
- no wheels are rendered in vice city and gta3 mode, you will see red boxes inst
ead.
________________________________________________________________________________
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!!