(English)
(German, Deutsch)


                 San Andreas Golf (SA Golf)

       A gta fan project by GoodIdea (c), Version 1.0, November 2013


### ENGLISH ##############################################################

Now you can play golf at the golf courses in Las Venturas and San Fierro! 
This mod adds realism to the game and extends gameplay. The aiming direction 
of the ball is shown by an animated trajectory ball (similar as in Billiard).
However, the aiming direction is shown at an angle so you have to think
three dimensional; this makes the game more interesting. By choosing the 
next or previous weapon you can select different golf clubs for short, 
medium, or long distance. The longer you hold the left mouse button the 
further you hit the ball. A distance bar indicates how long you hold be 
button, but you should develop a feeling how long to hold it. To start a 
golf game, enter the red marker near the golf club house in Las Venturas or 
in San Fierro. If you win on difficulty level medium or hard on all three 
locations without restarting the game, then you will win the Grand Slam. 
Read the Readme of this mod! This mod is based on CLEO 4.

Author: GoodIdea

----- Installation ------------------------------------------------------

0. Backup files

1. Install CLEO 4 and GXT Hook (See:  http://sannybuilder.com/
   and GXT Hook: http://cleo.sannybuilder.com/plugins/gxthook.rar)
   You should then see a CLEO folder in your GTA San Andreas folder (GTASA).
   
2. Copy content of CLEO into the CLEO folder of your San Andreas installation.

3. Add the file models\gta3.img\golfani.ifp  into GTASA\models\gta3.img 
   using for instance IMGManager (http://www.gtagarage.com/mods/show.php?id=4052). 

4. Adding collision data of the golfball object. Otherwise the ball will fall through the ground.
  Option A:
    Import and overwrite the file models\gta3.img\multiobj.col into gta3.img using IMGManager.
    Remark: The provided multiobj.col already contains the volleyball net
            in case you have or want to install "SA Volleyball".
  Option B (if you don't want to replace your multiobj.col with the provided one):
    Export multiobj.col from your gta3.img using IMGManager. 
    Use CollEditor2 (http://www.gtagarage.com/mods/show.php?id=1154) 
    to insert kb_golfball.col into the exported multiobj.col. 
    Import your multiobj.col back into gta3.img using IMGManager.
      
5. Add the following line into data\object.dat near the line starting with "beachball":
kb_golfball,		0.5,		0.00005		0.013,		0.25,		50.0,		0.0,  	2.0,    0, 	2,	1, 	0,	0,	0.0, 0.0, 0.0,		none
 Do NOT copy Object.dat.txt to your data folder!

Remark: The folder Optional2 contains a SAMI script for automatic installation.
        Unfortunately when testing the script did not copy the multiobj.col file
        correctly into gta3.img. 


----- Try also my other mods ---------------------------------------------

Link: https://www.youtube.com/user/GoodIdea82/videos

- SA Volleyball
- SA Tennis
- Camping Car Mobile Save House
   

----- Hints, Issues, Troubleshooting ------------------------------------

- I had no crashes when testing this mod with several other mods, but
  there can be problems under some configurations. In particular, I use one
  global variable for the distance bar (a global variable has to be used).
  Global variables are unsafe to use. But as I said, I didn't have problems.

- Press the shift-key to select a menu item after entering the red marker.

- If the ball is lost, or not displayed, or if you want to repeat a shot 
  for practice, then press the ResetBallKey. See golf.ini.
  
- If you cannot move CJ because he is aiming the ball, or if you want to quit
  the game, then also use the ResetBallKey button. To quit the golf game hold it 4 seconds.

- If you spawn directly to or between the golf fields (e.g. using a mod), then 
  initialization and deinitialization of the fields may not finished. I.e., there may
  be unexpected effects, for instance, the field may not exist.

- The mod accesses two global variables for communication between GolfStarter.cs 
  and golf.cm. If there is a conflict with another script you can change the
  variables in CLEO\golf.ini. 

- If you hit the ball directly against a wall or against a steep hill, then the 
  ball may go through the wall or ground. (Press ResetBallKey) 

- Hint: install a taxi mod to quickly travel between the fields.


----- Graphics Hints -----------------------------------------------------

Some people ask me about my graphics mods. If you don't know how to 
improve your graphics, here are some basic graphics hints:
- In the folder "Optional" I have added my timecyc.dat, enbpalette, 
  and enb settings for enb 0.076. Delete "effect.txt" if your computer is slow.
- I use textures from SRT 3 Mipmap edition and from ROSA Project, but there 
  are several other great mods such as HRT 1.4.
- Plants from BOGT (Behind Speyce Of Realities). 
- Project 2dfx
- HD Grass from Vegation Pack, but you will have grass in the 
  desert. I fixed this problem but it's not ready for publication yet. 
- I have several other graphics mods installed and modified almost
  all of them but the above is the basic setup I think.


---- Copy Right ------------------------------------------------

Feel free to copy and distribute this mod but you must include this description.
Do not steel this mod (i.e. do not change author)! Do not change this mod without
my permission! You may only change the configurations to make it run.


---- Disclaimer -----------------------------------------------

This is a fan project intended to extend and improve GTA San Andreas.
GTA is a trademark of Rockstar Games. Please buy their games to
support the company for their wonderful games. Use this software on 
your own risk. This software is provided as it is without 
any guarantees or obligations.

---- Link ---------------------------------------------

https://www.youtube.com/user/GoodIdea82/videos


### GERMAN, DEUTSCH ##########################################################################

Jetzt kann man Golf auf den Golfpltzen in Las Venturas und San Fierro spielen!
Diese Mod fgt Realismus hinzu und bereichert das Gameplay von GTA SA.
Die Richtung in die man den Ball zielt wird durch eine animierte Trajektorie
angezeigt (hnlich wie beim Billiard). Die Richtung wird in einem Winkel
dargestell, sodass man drei dimensional denken muss; das macht das Spiel 
interessant. Durch whlen der nchsten oder vorherigen Waffe kann man 
unterschiedliche Golfschlger auswhlen, fr kurze, mittlere, oder lange
Distanz. Je lnger man die Maustaste gedrck hlt, desto weiter fliegt 
der Ball. Die Weite wird durch einen Balken angezeigt, aber du solltest
ein Gefhl fr die Schussweite entwickeln. Ein Golfspiel wird gestarted 
indem man sich in einen roten Marker in der Nhe der Golfclubgebude
in San Fierro oder Los Santos begibt. Wenn du auf dem Schwierigkeitsgrad 
Medium oder Hard auf beiden Feldern gewinnst, ohne das Spiel neu zu starten, 
dann gewinnst du den Grand Slam. Lese die Readme dieser Mod! 
Die Mod basiert auf CLEO 4.

Autor: GoodIdea

----- Installation ------------------------------------------------------

0. Sichere deine Dateien

1. Installiere CLEO 4 und GXT Hook (See:  http://sannybuilder.com/
   GXT Hook: http://cleo.sannybuilder.com/plugins/gxthook.rar)
   Ein CLEO Verzeichniss sollte im Verzeichnis GTA San Andreas (GTASA) zu sehen sein.
   
2. Kopiere den Inhalt aus CLEO in das CLEO Verzeichnis deiner San Andreas Installation.

3. Fge die Datei models\gta3.img\golfani.ifp  in GTASA\models\gta3.img hinzu.
   Dazu kannst du z.B. IMGManager (http://www.gtagarage.com/mods/show.php?id=4052) benutzen.

4. Als nchste werden Kollisionsdaten fr den Golfball hinzugefgt. Sonst fllt der Ball durch den Boden.
  Option A:
    Importiere und berschreibe die Datei models\gta3.img\multiobj.col in gta3.img mit dem IMGManager.
    Anmerkung: Die mitgelieferte multiobj.col Datei enthlt bereits das Volleyballnetz
            falls du "SA Volleyball" installiert hast oder installieren willst.
  Option B (falls du deine multiobj.col nicht mit meiner ersetzen willst):
    Exportiere multiobj.col aus deiner gta3.img mit dem IMGManager. 
    Verwende CollEditor2 (http://www.gtagarage.com/mods/show.php?id=1154) 
    um kb_golfball.col in die exportierte multiobj.col einzufgen.
    Importiere deine multiobj.col zurck in die gta3.img mit dem IMGManager.
      
5. Fge folgende Zeile in data\object.dat ein (nach der Zeile die mit "beachball" anfngt):
kb_golfball,		0.5,		0.00005		0.013,		0.25,		50.0,		0.0,  	2.0,    0, 	2,	1, 	0,	0,	0.0, 0.0, 0.0,		none
 Kopiere jedoch nicht die Datei Object.dat.txt in das data Verzeichnis aus GTASA!

Anmerkung: Das Verzeichnis Optional2 enthlt ein SAMI script fr eine automatische Installation.
        Leider Kopiert das Skript die Datei multiobj.col nich richtig nach gta3.img. Die
        Datei wird beschdigt.


----- Probiere auch meine anderen Mods aus ------------------------------------

Link: https://www.youtube.com/user/GoodIdea82/videos

- SA Volleyball
- SA Tennis
- Camping Car Mobile Save House
   

----- Hinweise, Probleme, Fehlerbehebung ------------------------------------

- Ich hatte keine Probleme mit der Mod, auch nicht in Verbindung mit anderen Mods.
  Bei manchen Konfigurationen kann es jedoch zu Problemen kommen. Insbesondere
  verwende ich eine globale variable fr den Distanz/Zeitbalken, weil es
  nur mit einer globalen variablen funktioniert. Solche Variablen sollten 
  eigentlich nicht verwendet werden, aber wie gesagt, hatte ich noch keine
  nennenswerten Probleme.

- Drcke die Shift-Taste um Menu-elemente auszuwhlen, nachdem du den roten
  Marker betreten hast.

- Wenn der Ball verloren gegangen ist, nicht dargestellt wird, oder wenn du
  zur bung einen Schlag wiederholen willst, dann drcke die RestBallKey Taste. Siehe golf.ini.

- Falls du CJ nicht bewegen kannst, weil er im Zielmodus ist, oder wenn du
  das Spiel beenden willst, dann drcke ebenfalls die ResetBallKey Taste.
  Um das Spiel zu beenden halte sie 4 Sekunden gedrckt.

- Wenn du CJ direct zu (oder zwischen) Volleyballfeldern teleportierst (z.B. mit einer Mod)
  dann kann es sein, dass die Initialisierung und Deinitialisiert eines Spielfeldes nicht
  nicht fertig wird. D.h., es knnen unerwartete Effekte entstehen.

- Diese Mod verwendet zwei globale Variables um daten zwischen VolleyballStarter.cs 
  und Volleyball.cm auszutauschen. Wenn es dies zu einem Konflikt mit einem anderen Skript
  fhrt, dann kann man andere Variablen in CLEO\volleyball.ini whlen. 
  Meine vorhergehende "Camping Car Mobile Save House" verwendet auch diese Variablen,
  aber dies sollte zu keinen Problemen fhren.

- Wenn man den Ball direkt gegen eine Wand oder einen Steilen Hgel Schlgt,
  dann kann es passieren, dass der Ball durch die Wand oder den Boden fliegt. (Drcke ResetBallKey)

- Tipp: Installiere eine Taxi mod um schnell zwischen den Felder zu reisen.


----- Grafik Tipps -----------------------------------------------------

Manche Leute haben mich gefragt, welche Grafikmods ich verwende. Falls du
dich nicht auskennst, sind hier ein paar elementare Tipps.
- Im Verzeichniss "Optional" habe ich meine timecyc.dat, enbpalette, 
  und enb Einstellungen fr enb 0.076 mit geliefert. Lsche "effect.txt" aus enb
  falls dein Computer langsam ist.
- Ich verwende Texturen aus SRT 3 Mipmap edition und ROSA Project, aber es gibt
  auch viele andere tolle textur mods z.B. HRT 1.4.
- Pflanzen aus BOGT (Behind Speyce Of Realities). 
- Project 2dfx
- HD Grass aus Vegation Pack, aber du wirst leider Grass in der Wste sehen.
  Ich habe das Problem bei mir behoben, aber es ist nicht fertig zum Verffentlichen.
- Ich habe noch mehrere andere Grafikmods installiert und fast alle modifiziert
  aber die oberen bilden eine gute Ausgansbasis.


----- Kopierrecht ------------------------------------------

Diese Mod darf kopiert und verteilt werden, aber diese Beschreibung muss
immer dabei sein. Diese Mod darf nicht gestohlen werden (d.h. der Name des
Autors darf nicht verndert werden)! Diese Mod darf ohne meine Erlaubnis
nicht verndert werden. Die Mod darf nur soweit verndert werden, 
um sie zum Laufen zu bringen.

-----  Haftungsausschluss ------------------------------------

Das ist ein Fanprojekt, welches versucht GTA San Andreas zu erweitern und zu 
verbessern. GTA is eine Marke von Rockstar Games. Bitte kauft deren Spiele 
und unterstzt die Firma fr ihre wundervollen Produkte.
Der Entwickler dieser Software haftet fr keine Schden, bernimmt keine
Verantwortung, und hat keine Verpflichtungen.

---- Link ---------------------------------------------
https://www.youtube.com/user/GoodIdea82/videos



