(English)
(German, Deutsch)


                 San Andreas Tennis (SA Tennis)

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


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

Play tennis at the tennis courts in San Andreas! This mod adds realism
to the game and extends gameplay. To start a tennis game enter the red
marker at either of the tennis courts in Los Santos, San Fierro, or
Las Venturas during daytime. If you win on difficulty level medium or
easy on all three courts without restarting the game, then you will
win the Grand Slam. This is possible with practice, and without cheating.
Read the Readme of this mod! This mod is based on CLEO 4 and can be 
installed with SAMI.

----- Installation (quick info) -----------------------------------------
1. Install CLEO 4 and GXT Hook
2. Install SAMI
3. Install "tennis.sami"
4. Install one of the following
     "tennis_racket_for_gta_sa.exe_with_14.383.616bytes.sami"
     "tennis_racket_for_gta_sa.exe_with_14.386.176bytes.sami"
     "tennis_racket_replace_baseball_bat.sami"
	 
----- Installation (better explained) -------------------------------------------
0. Create a backup if you want but don't blame me otherwise. 

1. Install CLEO 4. See for instance:  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. Install the San Andreas Mod Installer V1.1, also known as "SAMI".    
   (For instance: http://www.gtainside.com/download.php?do=comments&cat=112&start=&id=5604
    http://grandtheftauto.filefront.com/file/San_Andreas_Mod_Installer_SAMI;55091#Download)
   	   
3. Install "tennis.sami" using SAMI (Follow instructions of SAMI). When
   running SAMI, select to install from the folder, where you have uncompressed
   this mod. "tennis.sami" will install the the CLEO game code and the 
   tennis ball. Test it before you proceed with the next step: start GTA
   and check if you see a red marker at one of the tennis fields. 
   See below for troubleshooting.   

4. Install the tennis racket (optional but recommended). I give you several
   options to choose from. If one option didn't work, you can still try the
   others. Install ONLY ONE of the following. See below for troubleshooting.
   4A. Two possibilities are to instal the racket as an additional weapon 
        with weapon limit adjuster (included in this package) from Ryosuke839. 
        The weapon limit adjuster works only with specific versions of the 
        gta_sa.exe (check how many bytes yours has)	so you can choose to install
        - either, "tennis_racket_for_gta_sa.exe_with_14.383.616bytes.sami"
        - or, "tennis_racket_for_gta_sa.exe_with_14.386.176bytes.sami"
   4B. If the weapon limit adjuster doesn't work for you, the third option
       is to replace the baseball bat by the tennis racket. To to this
       install "tennis_racket_replace_baseball_bat.sami"
	   
5. (Optional) Tennis field texture. I use the texture pack "SRT 3". The field
   dimension is based on this texture, so I recommend to install "SRT 3", too. 
   (e.g. from here http://www.moddb.com/mods/srt3-mod)
   
----- Issues, Troubleshooting, Manual Installation --------------------
- I had no problems when testing this mod with several other mods, but
  there can be problems under some configurations.
  
- Doing Cleanup. If you encounter a problem and want to retry the installation, 
  then FIRST UNINSTALL the *.sami script that you you want to reinstall. SAMI 
  offers a button for this. SAMIs cleanup is however not complete! You have 
  to manually delete in your GTASA folder the "weaponlimit....asi" in your GTASA
  folder if present and delete "tennis.cs" and "tennis.ini" in GTASA\CLEO.

- If game crashes at the very beginning, then there may be a problem with
  weaponlimit adjuster. If game crashes on tennis field, after selecting
  the difficulty level, then there probably a problem with the installation
  of the ball model or the tennis racket.
  
- Do manual installation for better troubleshooting. You basically follow 
  the *.sami scripts (you can open the *.sami script with a text editor)
  and can make custom adjustments.
  
  - Step 3. Follwoing "tennis.sami"
  -- Add the models and textures  "tennisball1.txd", "tennisball1.dff", and
    "tennisball1.col" (located in SAFolder\models) into models\gta3.img.
	You can do this manually using, for instance, IMGManager.
  -- Add the line
     19632, tennisball1, tennisball1, 50, 128
     into the textfile data\maps\generic\multiobj.ide 
     The 19632 is the object ID of the tennisball I use. You may have to 
     change this value if some other mod also uses the ID. 
     See: "Free ID List Generator" http://www.gtagarage.com/mods/show.php?id=16944	 
  -- Add the line
     tennisball1,		0.1,		0.00001		0.04,		0.75,		50.0,		0.0,  	2.0,    0, 	2,	1, 	0,	0,	0.0, 0.0, 0.0,		none
     into the textfile data/object.dat.
     Don't change these values, I optimized them a very long time. When changing
     them, the ball may fall through the ground. 
  -- Copy SAFolder\CLEO\tennis.cs to your GTASA\CLEO\tennis.cs. This is the
     game code of this mod. If not already present also copy FileSystemOperations.cleo
     and IniFiles.cleo so that tennis.cs can read tennis.ini. (I'm not
     if IniFiles.cleo needs FileSystemOperations.cleo.)
  -- (Optional) Copy and edit SAFolder\CLEO\tennis.ini into 
      your GTASA\CLEO\tennis.ini. Read the readme there.
	  
  - Step 4A. Following tennis_racket...sami with weapon limit adjuster by Ryosuke839 / catzilla.
  -- Add the models and textures "tennisracket.txd", "tennisracket.dff" 
    (located in SAFolder\models) into models\gta3.img.
    You can do this manually using, for instance, IMGManager.
  -- Add the "weapon*" files from SAFolder to your GTASA folder. Copy either
     the weaponlimit.asi from SAFolder or from SAFolder\alternative_weaponlimit.
     If you are alrady using a weapon limit adjuster, you have to edit the text
     files instead by adding a new weapon. You can find a tutorial on the net.
  -- Add the line
     19633, tennisracket, tennisracket, null, 1, 50, 0
     into data\default.ide below the line starting with # melee weapons,
     The 19633 is the object ID of the tennisracket I use. You may have to 
     change this value if some other mod also uses the ID. 
     See: "Free ID List Generator" http://www.gtagarage.com/mods/show.php?id=16944	 
  -- Add the line
       TENNISRACKET	MELEE	10.0  1.6	19633	-1		1		BBALLBAT	1			1		null
     data\weapon.dat after the line starting with  BASEBALLBAT.
	 
  - Step 4B. Following tennis_racket...sami without using the weapon limit adjuster
    This is an alternative to 4A!
  -- Add the models and textures "bat.txd", "bat.dff" 
    (located in SAFolder\alternative_models) into models\gta3.img. 	
	This will overwrite the original baseball bat.
  -- Delete weapon limit files if they were introduced by your previous
     installation of this mod.
  -- Either delte CLEO\tennis.ini or recommended edit CLEO\tennis.ini to use
     the ids and numbers for using the bat as a tennis racket.


----- Usage ------------------------------------------------------
Go to red maker of a tennis field. There must be a 2nd ped near the marker.
Follow instructions. CJ hits the ball automatically, when it's in front of 
him. You controll the direction of the ball with left\right. Combine 
left\right with the Sprint key, i.e. the key for running fast, to stronger 
change the direction of the ball. 

---- Credits ----------------------------------------------------
- Ryosuke839 / catzilla for weapon limit adjuster

---- 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 get it running.

---- 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 ---------------------------------------------


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

Spiele Tennis auf den Tennisfeldern in San Andreas! Die Mod fgt Realismus 
hinzu und bereichert das Gameplay von GTA SA. Ein Tennisspiel wird gestarted 
indem man sich in einen roten Marker auf den Tennisfeldern in Los Santos,
San Fierro, oder Las Venturas begibt. Wenn du auf dem Schwierigkeitsgrad
Medium oder Hard auf allen drei Feldern gewinnst, ohne das Spiel neu zu 
starten, dann gewinnst du den Grand Slam. Durch bung ist das mglich ohne
das Tennisspiel zu betrgen. Lese die Readme dieser Mod! Die Mod basiert
auf CLEO 4 und kann mit SAMI installiert werden.


----- Installation (kurz und knapp) -----------------------------------------
1. Installiere CLEO 4 und GXT Hook
2. Installiere SAMI
3. Installiere "tennis.sami"
4. Installiere eines der folgenden Dateien.
     "tennis_racket_for_gta_sa.exe_with_14.383.616bytes.sami"
     "tennis_racket_for_gta_sa.exe_with_14.386.176bytes.sami"
     "tennis_racket_replace_baseball_bat.sami"
	 
----- Installation (genauer erklrt) -------------------------------------------
0. Erzeuge eine Sicherheitskopie. 

1. Installiere CLEO 4. Siehe z.B:  http://sannybuilder.com/
   und GXT Hook: http://cleo.sannybuilder.com/plugins/gxthook.rar
   Danach solltest du ein CLEO Verzeichnis in dem GTA San Andreas Verzeichnis 
   (GTASA) sehen.

2. Installiere den San Andreas Mod Installer V1.1, auch bekannt als "SAMI".    
   (z.B: http://www.gtainside.com/download.php?do=comments&cat=112&start=&id=5604
    http://grandtheftauto.filefront.com/file/San_Andreas_Mod_Installer_SAMI;55091#Download)
   	   
3. Installiere "tennis.sami" mit Hilfe von SAMI (Folge den SAMI Anweisungen). Wenn
   SAMI dann whle mit "Folder" am besten das entpackte Verzeichniss diesre Mod.
   "tennis.sami" wird den programm code (CLEO) und den Tennisball installieren.
   Teste es bevor du mit zum nchsten Punkt kommst: starte GTA
   und berprfe ob du die roten Marker auf einem Tennisfeld siehst. 
   Siehe unten Problembehandlung.

4. Installiere den Tennisschlger (optional aber empfohlen). Ich stelle mehrere
   Optionen zur auswahl. Wenn eine Option versagt, dann kannst du noch eine
   andere probieren. Installiere NUR EINE der folgenden Erweiterungen. Lese
   auch die Problembehandlung unten.   
   4A. Zwei Optionen erlauben es den Tennisschlger als eine Zustzliche Waffen 
        mit dem "weapon limit adjuster" (beigefgt in dem Paket) von Ryosuke839 zu
		installieren. Der "weapon limit adjuster" funktioniert nur mit bestimmten
        Versionen der gta_sa.exe (berprfe die Anzahl der Bytes), also musst du eine
        auswhlen.
		- entweder, "tennis_racket_for_gta_sa.exe_with_14.383.616bytes.sami"
        - oder, "tennis_racket_for_gta_sa.exe_with_14.386.176bytes.sami"
   4B. Falls der "weapon limit adjuster" nicht funktioniert, dann ist die dritte
       Mglichkeit den Baseballschlger mit dem Tennisschlger zu ersetzen. 
       Installiere dazu "tennis_racket_replace_baseball_bat.sami".

5. (Optional) Textur des Tennisfeldes. Ich benutze die Texturen von "SRT 3". 
   Die Dimensionen der Spielfelder basieren auf diesen Texturen, daher 
   empfehle ich SRT 3 auch zu installieren.    
   (z.B. von hier http://www.moddb.com/mods/srt3-mod)

	
----- Problembehandlung, Manuelle Installation --------------------
- Ich hatte beim Testen keine Probleme, auch nicht in Kombination mit anderen
  Mods. Aber bei bestimmten Konfigurationenn knnen durchaus Probleme auftreten.
  
- Aufrumen. Falls es ein Problem gab und du die Installation wiederholst, dann
  DEINSTALLIERE ZUERST das *.sami Skipt das du erneut installieren willst. SAMI
  hat dafr einen Knopf. SAMIs deinstallation ist jedoch nicht vollstndig.
  Man muss manuel "weaponlimit....asi" im  GTASA Verzeichnis und 
  "tennis.cs" und "tennis.ini" in GTASA\CLEO lschen.

- Falls das Spiel direkt am Anfang abstrztzt, dann gibt es vielleicht ein Problem
  mit dem  weapon limit adjuster. Wenn das Spiel auf dem Tennisfeld abstrzt, 
  nachdem du den Schwierigkeitsgrad ausgewhlt hast, dann liegt das vermutlich
  an der Installation des Tennisballs oder des Tennisschlgers. 
  
- Fhre eine manuelle Installation durch um Probleme besser lsen zu knnen. 
  Dazu folgt man einfach den Anweisungen, die in den *.sami Skripten stehen
  und nimmt eigene Anpassungen vor. SAMI Skripte knnen mit einem Texteditor 
  gelesen werden.
  
  - Schritt 3. "tennis.sami"
  -- Fge folgende Modelle und Texturen "tennisball1.txd", "tennisball1.dff", und
    "tennisball1.col" (siehe SAFolder\models) in models\gta3.img ein.
    Das kann man manuell mit, z.B., IMGManager tun.
  -- Fge die Zeile
     19632, tennisball1, tennisball1, 50, 128
     in die Textdatei data\maps\generic\multiobj.ide 
     Die Zahl 19632 ist die object ID des Tennisballs die ich benutze. Du kannst den
     wert anpassen um Konflikte mit anderen Mods zu lsen. 
     Siehe: "Free ID List Generator" http://www.gtagarage.com/mods/show.php?id=16944	 
  -- Fge die Zeile
     tennisball1,		0.1,		0.00001		0.04,		0.75,		50.0,		0.0,  	2.0,    0, 	2,	1, 	0,	0,	0.0, 0.0, 0.0,		none
     in die Textdatei data/object.dat ein.
     Verndere die Werte nicht, da ich sie lange Zeit optimiert habe. Durch nderungen
     kann der Ball manchmal durch den Boden fallen. 
  -- Kopiere SAFolder\CLEO\tennis.cs nach GTASA\CLEO\tennis.cs. Das ist der Programmcode.
     Falls noch nicht vorhanden, kopiere auch FileSystemOperations.cleo
     und IniFiles.cleo damit tennis.cs die Datei tennis.ini lesen kann. (Bin mir 
     nicht sicher ob IniFiles.cleo die Datei FileSystemOperations.cleo braucht.)
  -- (Optional) Kopiere und editiere SAFolder\CLEO\tennis.ini nach
     GTASA\CLEO\tennis.ini. Lese die Readme dort. Man muss ggf. Object IDs anpassen.
	  
  - Schritt 4A. Folge tennis_racket...sami mit weapon limit adjuster von Ryosuke839 / catzilla.
  -- Fge folgende Modelle und Texturen hinzu:"tennisracket.txd", "tennisracket.dff" 
    (siehe SAFolder\models) in models\gta3.img in.
     Das kann man manuell mit, z.B., IMGManager tun.
  -- Fge die "weapon*" Dateien aus SAFolder in dein GTASA Verzeichnis ein. Kopiere
     entweder weaponlimit.asi aus SAFolder oder aus SAFolder\alternative_weaponlimit.
     Wenn du einen weapon limit adjuster schon verwendest, dann must du die entsprechenden
     Textdateien editieren um eine neue Waffe hinzuzufgen. Es gibt Tutorials im Netz.
  -- Fge die Zeile
     19633, tennisracket, tennisracket, null, 1, 50, 0
     in data\default.ide unter die Zeile mit # melee weapons ein.
     Die Zahl 19633 ist die ObjektID des Tennisschlgers die ich benutze. Eventuell must
     du diesen Wert verndern falls er von anderen Mods verwendet wird. 
     Siehe: "Free ID List Generator" http://www.gtagarage.com/mods/show.php?id=16944	 
  -- Fge die Zeile
       TENNISRACKET	MELEE	10.0  1.6	19633	-1		1		BBALLBAT	1			1		null
     in data\weapon.dat nach der Zeile mit  BASEBALLBAT ein.
	  
  - Schritt 4B. Folge tennis_racket...sami ohne weapon limit adjuster zu benutzen.
    Das ist eine Alternative zu 4A!
  -- Fge folgende Modelle und Texturen hinzu:"bat.txd", "bat.dff" 
    (siehe SAFolder\alternative_models) in models\gta3.img ein. 	
	Dadurch wird der Baseballschlger durch den Tennisschlger ersetzt.
  -- Lsche weapon limit Dateien falls sie durch einen frhere Installation dieser
     Mod hinzugefgt wurden.
  -- Entwedern lsche CLEO\tennis.ini oder besser, editiere CLEO\tennis.ini 
     um die IDs und Numern des Baseballschlgers zu verwenden.


----- Verwendung ------------------------------------------------------
Gehe zum roten Marker auf einem Tennisfeld. Dort muss sich eine zweite
Person befinden. Folge den weiteren Anweisungen. CJ schlgt den Ball
automatisch, wenn sich dieser vor ihm befindet. Man kontrolliert die
Richtung des Balls mit Links\Rechts. Kombiniere Links\Reckts mit der 
"Sprint" Taste um den Ball strker nach links\rechts zu schlagen.
Die Sprint Taste ist die Taste um schneller zu laufen.

----- Danke -------------------------------------------------------
- An Ryosuke839 / catzilla fr den weapon limit adjuster.

----- 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.

