



EINLEITUNG:
======================================================================================================

	Wir wollen euch den ACRE-Mod vorstellen, der von Mitgliedern der ArmA2-Communitity
	entwickelt wurde um Teamspeak 3 und ArmA 2 zu verbinden.
	Mit Positional-3D-Audio und realistischen Funknetzwerken schafft ACRE eine unglaublich
	berzeugende Spielumgebung.
	
	Ziel der Entwicklung war es, eine mglichst realittsnahe Kommunikationslsung fr ArmA2 zu schaffen.
	Die verwendeten Verlust- und Abschattungs-Modelle sind weitestgehend wirklichkeitsnah und bercksichtigen
	Faktoren die auch den Funk unter realen Bedingungen mageblich beeinflussen.
	Wir freuen uns ber euer Feedback und laden natrlich jeden ein, der an diesem Projekt mitarbeiten will.

	Euer ACRE-Team
		Nou	-	Developer
		Rommel	-	Developer
		Vigilante	-	Developer, Graphics
		jaynus	-	Developer
		ThePieSpy	-	Graphics


FEATURES
======================================================================================================
	* Sprach-Kommunikation (ohne Funk)
		. Direkte Sprachkommunikation (auf Rufweite) mit Echtzeit-3D-Positional-Audio
		
	* 2 spezielle ACRE-Funkgerte
		. PRC-119 Tragbares Tornister-Funkgert
		. PRC-148 Hand-Funkgert
	* 100% ACE2 Kompatibel
		. Funktioniert mit allen ACE2 Tornister-Funkgerten (basierend auf den Daten des AN/PRC-119)

	* Das PRC-148 ersetzt nun das standard ArmA2-Handfunkgert.

	* Realistische Bedienelemnte fr die Funkgerte

	* Realistisches Gelndeabschattungsmodell
		. Signal-Verluste und Strungen durch Gelnde, Gebude, Bume und andere Objekte
		. Gerte-Leistung und Antennenlnge beeinflussen das Signal 
		. Freqeuzabhngiger Feldstrkenabfall (Hohe Frequenzen haben eine geringere Reichweite)
		. Echtzeit Positionsberechnung fr sich schnell bewegende Objekte

	* Eigene Push-To-Talk Taste (non-toggle) fr den Funk
		. Wenn ein Spieler funkt und Du nicht auf dessen Frequenz bist, hrst Du ihn 'direkt' (Sofern Du nah genug bist)

	* Hotkeys und Schnellansichten fr Infos zu Deinen Funkgerten

	* Ein Spieler kann mehrere Funkgerte auf verschiedenen Frequenzen bei sich tragen
		. Hotkey um zwischen den Gerten zu wechseln
		. Men zur Auswahl des Funkgertes
		. Pop-up-Anzeige whren der Kommunikation um das aktuell benutze Gert anzuzeigen
	* Jedes Gert ist ein eigenstndiges Objekt innerhalb der Spielwelt
		. Die Funkgerte knnen abgelegt werden, und behalten ihre Einstellungen, egal wer sie wieder aufnimmt.
		. Du kannst also ein Fungert einstellen und es einem Mitspieler so geben
		. Schnapp Dir das Gert eines toten Gegners und finde so die Frequenz seiner Einheit heraus
	* Tornister-Gerte knnen in Fahrzeugen im 'PA' betrieben werden und erreichen so eine Sendeleistung von 40.000mW!
	* Persnliche "Squawk-sounds" fr alle bertragungen (Danke Krause)
	* Realistische Verzerrungseffekte
		. Normales Grundrauschen
		. Verzerrungen durch Signalverluste.
	* 100% BattlEye Kompatibel
	* Performance and desync wurden bercksichtigt
		. Alle Zeitkritischen Informationen werden von Teamspeak3 abgehandelt, Server-desyncs beeinflussen ACRE nicht
		. Crash/Desync fallback Funktionalitt. Keine Sound "anomalien" bei Server-Desyncs.
		. Optimierte Entfernungs-, Gelnde-, Positions- und Signal-Berechnungen
		. ACRE benutzt die Named pipes der JayArmA2Lib zur Kommunikation; Null-Latenz Inter-Prozess-Kommunikation zwischen TS3 und ArmA2
		. Serverside garbage collection der Funkgerte, um Objectclutter und Lags bei lngeren Missionen vorzubeugen
	* Viele fixes fr ts3/arma2 crashes, server/mission disconnects
		. Globaler 15 sekunden Reset fr solche Flle
		

BEKANNTE PROBLEME
======================================================================================================
	* Wenn Du TS3 als Administrator ausfhrst, empfehlen wir auch ArmA2 als Administrator auszufhren
	* PRC-148 
		. Lsst sich nicht mit eigenen Frequenzen programmieren. 100 voreingestellte Channels/Frequenzen vorhanden
		. Kann nur mit 100mw betrieben werden (auch wenn damit in Wirlichkeit bis zu 5W mglich sind)
	* PRC-119 
		. Frequenz-Programmierung etwas "wackelig". Immer zuerst resetten, dann programmieren
		. Bedienelemente zur Programmierung sind nicht original; (um es Anfngern etwas zu erleichtern)
		. Kann keine eigenen Frequenzen im Kanal speichern
	* Voice Activation ist nicht wirklich getestet. Benutzung auf eigene Gefahr.
	* Noch immer passiern etwas seltsame Dingen mit den Funkgertemn, wenn man in einer Mission sehr oft stirbt
	* Bei Server-Desyncs kann das Ablegen/Aufnehmen von benutzten/neuen Gerten stark verzgert sein
		. Manchmal erscheint/verschwindet das Gert im Inventar - lass Dir zeit!
	* Fahrzeuge wie Flugzeuge haben keine eigenen Funkgerte, Du musst Dein eigenes mitnehmen.



BENTIGTE ADDONS
======================================================================================================
	* CBA - Community Base Addons (nicht inkludiert)
		. http://dev-heaven.net/wiki/cca
	* JayArmA2Lib (inkludiert)
		. http://dev-heaven.net/projects/jayarma2lib/wiki


INSTALLATION/DEINSTALLATION
======================================================================================================
	Client Installation
		Zur Zeit gibt es zwei mglichkeiten um ACRE zu installieren
		Im Paket ist sowohl ein ausfhrbarer Installer (*.exe) als auch die einzelnen Dateien enthalten, die dann einfach in die
		entsprechenden Verzeichnisse kopiert werden knnen.
		Wir empfehlen die Installer-Methode. Sollte das nicht klappen, findet ihr hier nachstehend die "Ordner-Methode" beschrieben.

	Wichtige Hinweise!
		- @JayArmA2Lib Verzeichnis darf NICHT umbenannt oder verschoben werden.
		- dsound.dll muss in Eurem ArmA2-Root liegen (z.B.: C:\Programme\Bohemia...\ArmA2\dsound.dll)

	Dateien und Verzeichnisse:
		ArmA2\ (z.B.: C:\Programme\Bohemia...\ArmA2\)
					@ACRE\
					. Hauptorder des Addons
					@JayArmA2Lib\ 
					. Kommunikation und Zusatzprogramme
					userconfig\ACRE\
					. Konfigurationsdateien
					dsound.dll
					. Implementierung der jayarma2lib
					
					
			Teamspeak 3 Client\ (z.B.: C:\Programme\TeamSpeak 3 Client\)
				plugins\ACRE.dll
					. TS3 plugin fr 32-bit systeme
				ACRE_x64.dll 
					. TS3 plugin fr 64-bit systeme
			
-----------------------------------------------------------------------------------------------------------

-- Automatische Installation --
	1. Vergewissere Dich dass ArmA2 und Teamspeak3 NICHT laufen
	2. Fhre ACREinstaller.exe als Administrator aus
	3. Folge den Anweisungen des Installers
	4. Vergewissere Dich, dass ALLE Dateien kopiert wurden (siehe oben: Dateien und Verzeichnisse:)
	5. Starte TeamSpeak 3, Klicke Settings -> Plugins, und vergewissere Dich, dass ACRE angewhlt ist (Hkchen)
	6. Starte TeamSpeak 3 neu
	7. Editiere Deine ArmA2 Verknpfung so, dass sie zumindest "@cba;@JayArmA2Lib;@ACRE" enthlt
	
-- Manuelle Installation --
	1. Vergewissere Dich dass ArmA2 und Teamspeak3 NICHT laufen
	2. Kopiere den Inhalt des ArmA2 Verzeichnisses in Dein ArmA2 Root-Verzeichnis
		. Im ArmA2 Root-Verzeichnis sollten nun @ACRE, @JayArmA2Lib, and dsound.dll zu sehen sein
	3. Kopiere (entsprechend Deinem System) die ACRE.dll (32-bit) oder die ACRE_x64.dll (64-bit) in Dein "Teamspeak 3 Client\plugins" Verzeichnis
	4. Starte TeamSpeak 3, Klicke Settings -> Plugins, und vergewissere Dich, dass ACRE angewhlt ist (Hkchen)
	5. Starte TeamSpeak 3 neu
	6. Editiere Deine ArmA2 Verknpfung so, dass sie zumindest "@cba;@JayArmA2Lib;@ACRE" enthlt

-- Installation auf dedizierten Servern --
	ACRE muss auch am Server installiert werden um die Synchronitt ablegter Funkgerte zu gewhrleisten.
	Am Server wird NUR das @ACRE Verzeichnis bentgt. Die JayArma2Lib wird am Server NICHT bentigt.
	Sie ist zwar Server-Kompatibel, wird aber wie gesagt nicht am Server bentigt.

	1. Vergewissere Dich, dass der Server nicht luft.
	2. Kopiere den @ACRE Ordner in das ArmA2-Root des Servers
	3. Editiere die Startverknpfung (Mod-Line) des Servers so, dass sie zumindest "@cba;@ACRE" enthlt
	
	
	
DEINSTALLATION
==============================================================================================================	

Automatische Deinstallation:
	1.Wenn Du ACRE automatisch installiert hast, kannst Du es unter Systemsteuerung->Software deinstallieren

Manuelle Deinstallation:
	1. Vergewissere Dich dass ArmA2 und Teamspeak3 NICHT laufen
	2. Lsche die ACRE.dll/ACRE_x64.dll aus Deinem "Teamspeak 3\plugins" Verzeichnis
	3. Lsche die Ordner @ats3 und @JayArmA2Lib aus Deinem ArmA2 Root-Verzeichnis
	4. Lsche die dsound.dll aus Deinem ArmA2 Root-Verzeichnis
	5. Entferne @ACRE und @JayArmA2Lib aus Deiner Startverknpfung

Server Deinstallation
	1. Vergewissere Dich, dass der Server nicht luft.
	2. Lsche den  @ats3 ordner aus dem ArmA2-Root des Servers
	3. Entferne @acre aus der Startverknpfung des Servers (Mod-Line)
	
	
EINFHRUNG
==============================================================================================================	
	Standardbelegung der Tasten:
		CTRL + SHIFT + X 
			. ffnet das GUI des aktuellen Funkgertes
		CTRL + SHIFT + C
			. Wechseln zwischen den Funkgerten die man bei sich trgt
		CTRL + SHIFT + V
			. Zeigt die aktuellen Informationen zu den getragenen Gerten, sowie die
				Mglichkeit zwischen ihnen zu wechseln
		CAPSLOCK
			. Funk: PTT(Push-To-Talk) Taste
			
** DIESE BELEGUNG KANN UNTER "ARMA 2\USERCONFIG\ACRE\ACRE_KEYS.HPP" GENDERT WERDEN **

		
GRUNDLEGENDE FUNKTIONEN
==============================================================================================================	
	Direktes Sprechen:
		Benutze deine standard TeamSpeak3 'Push-To-Talk'-Taste um im Spiel 'direkt' zu sprechen. In diesem Punkt
		ist alles wie gewohnt. Jedoch hren Dich nun nur noch Personen in Deiner nheren Umgebung sprechen.
		Beim direkten Sprechen, hrst Du Spieler mit 3D-Sound, entsprechende ihrer Position zu Dir in der Spielwelt.
		Hinweis:
			(Wenn Du in TS3 'Sprachaktivierung' benutzt, kommt es vor, da das Micro nicht mehr
			'aufmacht'. Workaround: Unter "TS->Einstellungen->Optionen/Aufnahme" auf 'Push-To-Talk' stellen,
			und 'Anwenden' drcken, dann wieder zurckstellen auf Sprachaktivierung und wieder 'Anwenden' drcken.)	
	
	
	Funkverkehr:
		Du startest eine Funkbertragung indem Du die Sprechtaste (Standardeinstellung: [CAPS LOCK]) gedrckt hltst.
		Lsst Du die Sprechtaste wieder los, ist die bertragung beendet.
		Funkbertragungen sind durch ein 'squak' am Anfang und ein 'squak' Ende der bertragung eingegrenzt.
		Achtung! Startest Du Deine bertragung gleichzeitig mit einem anderen Spieler, kommt es zu einer Rckkopplung
		die alle Zuhrer nervt. Achtet also auf Funkdisziplin. Solltest Du zwischen den 'squaks' nichts hren, bist Du
		mglicherweise auer Funkreichweite. Eingehende Funksprche sind immer mit einem leichten Hintergrundrauschen unterlegt.
		Keine Verzerrung und kein Rauschen heit also immer dass Du jemanden in Deiner nhe hrst.
			

HANDHABE DER GERTE
==============================================================================================================
	Wenn Du ein Spiel mit dem PRC-148 startest, wird es automatisch durch das ACRE-PRC-148 ersetzt.
 	Ist das ACRE-PRC-148 Dein einziges Gert, ist es auch Dein 'aktives Gert'.

	1.	Drcke [CTRL+SHIFT+V] um das bersichtsmen der verfgbaren Gerte zu ffnen.
			a.	Per Mausklick ein Gert aus Liste der verfgbaren Gerte auswhlen.
			b.	Nun kannst Du das Gert als Dein aktives Gert festlegen (Make active)
					und/oder die Bedienoberflche des Gertes anzeigen lassen (Open Radio).
					(Die Bedienoberflchen der Funkgerte wird nchsten Abschnitt beschrieben)
			c.	Drcke ESCAPE um das Men bzw. Gerte-Bedienoberflche wieder zu schlieen.

	2.	Um das 'aktive Gert' schlell zu wechseln, drcke die Hotkey-Kombination [CNTRL+SHIFT+C].
			Das aktive Gert wird dann kurz in der unteren rechten Bildschirmecke angezeigt.

	3. 	Um schnell in die Bedienoberflche des 'aktiven Gertes' zu gelangen, drcke die Hotkey-Kombination [CNTRL+SHIFT+X]. ([ESC] zum verlassen)
	
	4. 	Nun drcke [CAPSLOCK] (gedrckt halten) und sag: "Ich werde Feuerwehrmann ...".
			Jeder Mitspieler in Funkreichweite sollte Dich nun hren, sofern er die selbe Frequenz beutzt.
			Wenn Du [CAPSLOCK] wieder loslsst, ist der Kanal wieder frei um eine Antwort zu empfangen.


	
	Die Bedienoberflchen im einzelnen ([CNTRL+SHIFT+X]):
		
		AN/PRC-148 (Hand-Funkgert)
			
			- Pfeile nach [oben]/[unten]
				Auswahl des Kanals. (1-100, Achtung: Benutze auch wirklich den selben Kanal wie Deine Kameraden!)
				Die Kanalfrequenzen sind fest vorgegeben und knnen nicht gendert werden.
		
		AN/PRC-119 (Tornister-Gert)

			Das AN/PRC-119 bietet eine vielzahl an Funktionen, von denen zur Zeit noch nicht alle verfgbar sind.
			Hier die bersicht der zur Zeit zugnglichen Funktionen:
				
				- [Chan]
						Kanal-Auswahl ber den [Chan]-Drehknopf.	Auswahl aus 6 vorprogrammierten	Kanlen. 
				
				-[Ziffernblock]
						Zum Einstellen einer eigenen Frequenz. Um eine Frequenz einzustellen mach folgendes:
						a.	Kanalwahl [Chan] auf den zu berschreibenden Kanal stellen.
						b.	Klicke [CLR] am 'Ziffernblock'.
						c.	Die gewnschte 5-stellige Frequenz ber den [Ziffernblock] eingeben
							(Wenn Du z.B. die Frequenz 3.111 einstellen willst, schreib 0-3-1-1-1)
						d.	Klicke [CTO] am [Ziffernblock].
				
					-[RF PWR]
							Zum Einstellen der Sendeleistung. Wenn das Gert getragen wird: 400mW, 2200mW, 4000mW.
							In Fahrzeugen (PA Mode): 40000mW
		


DANKE AN:
==============================================================================================================	
	-kju & Sickboy fr den Projektplatz auf http://dev-heaven.net
	-Den ACRE Laborratten: Alderman, Bashi, DMC_RULEZ, h3killa, JDMT, Jen, Loggert, M1n1d0u, OrdeaL, sr5tactical, tranquillity
	-Der TacticalGamer.com Community frs testen: Krause, ThePieSpy, Zedic, Azzwort, Sandiford, Cro, gr!imreaper, Omega Team, TG Admins
	-Der http://dev-heaven.net Community, die sich geduldig unsere Beschwerden angehrt hat ;)
	-Der BI-Foren-Community fr die Untersttzung
	
