Project:	ACRE 
			Advanced Combat Radio Environment
Version: 	1.4.9
Website:	http://tracker.idi-systems.com/projects/acre

--- Authors ---
Nou - Developer
jaynus - Developer

-- Contributors ---
ThePieSpy - Graphics (PRC-119 GUI, PRC-148 GUI)
Steffen Frandsen - Graphics (PRC-152 model & GUI)
gmt2001 - Graphics (Volume knobs for PRC-343)

--- Introduction ---
We would like to introduce to you the ACRE mod, in production by various members of the A2 community. The ACRE mod links ArmA2 and Teamspeak3 to create a more immersive environment in which we play in, including positional audio, real radio communications and complete compatibility with the ACE2 ArmA2 project.

We intend to create the most realistic and immersive radio system within the current gaming world; based off of real life experience and knowledge, as well as the use of physical terrain obscuration, radio loss, distortion, and all other considers a real radio operator must make on a daily basis.

We welcome anyone to supply feedback or join in on this cooperative project.

- ACRE Team

--- Features ---
* Five ACRE-Specific Radios 
	. AN/PRC-119 man pack radio
	. AN/PRC-148 handheld radio
	. AN/PRC-117F man pack radio
	. AN/PRC-343 man pack radio
	. AN/PRC-152 handheld radio
* 100% ACE2 Compatible
	. Integration with all ACE2 man pack radios, using default AN/PRC-119 statistics.
* PRC-148 now replaces the default ArmA2 'ItemRadio'
* Realistic GUI interfaces for radios, they are the real thing
* Directional speaking for non-radio, normal communications
	. Real-time 3d positional information
* Realistic terrain affects for radios
	. Signal lose & distortion from buildings, hills, trees, and other objects
	. Realistic power output and antenna length considerations for all radios that effect signal
	. Realistic frequency wavelength falloff; higher frequencies do not travel as far
	. Real-time positional calculation for fast-moving objects
* Separate Push-To-Talk key (non-toggle) for using your radio
	. If a person speaks on their radio and you aren't on that frequency, you can hear them 'directly'
* Multiple hotkeys and quick-displays for fast information about your radios
* Players can carry multiple radios on different frequencies
	. Hot-swap radio hotkey
	. Current radios selection menu
	. Pop-up display on broadcast to know current radio in use
* Radios are now considered unique objects within the ArmA2 world
	. Radios are droppable and maintain ALL settings for anyone who picks them up
	. Program a radio and trade it with a player!
	. Pick up your dead enemies radio and discover his platoon's frequency
* Man pack Radios have the ability to use 'PA' mode in a vehicle, broadcast at 40,000mW!
* Custom Squawk sounds for all radio transmissions (credits to Krause)
* Realistic distortion effects
	. Normal broadcasting distortion
	. Signal lose distortion and noise
* 100% BattlEye compatible
* Performance and desync considerations
	. All time critical radio information is communicated via TeamSpeak3, server desync doesn't break ACRE
	. Crash/Desync fallback functionality. Sound "anomalies" are no longer possible with lag/desync.
	. Optimized distance, terrain, positional and signal calculations
	. Use of JayArmA2Lib for Named pipes communication; 0-latency inter-process communication between TS3-ArmA2
	. Server side garbage collection of radios to prevent object clutter/long mission lag
	. Many fixes for ts3/arma2 crashes, server/mission disconnects
		- Global 15 second reset for any of these scenarios
* Dead player and respawn handling for both radio and direct chat
	
--- Dependencies ---
* CBA - Community Base Addons (not included)
	. http://dev-heaven.net/wiki/cca
* JayArmA2Lib (Included)
	. http://dev-heaven.net/projects/jayarma2lib/wiki
* A2OA Beta/Release that includes callExtension if using included JayArma2Lib (1.60 Final requires old JayArma2Lib from link above)

		
--- Client Installation ---
Please follow the directions below to manually install ACRE. We recommend that you do this only if SIX updater fails for you or you prefer not to use SIX updater.

Directories and Files for Installation:

	-- ArmA 2\ Directory --
		@ACRE\ 
			. This is the main bulk of ACRE plugin
		@JayArmA2Lib\ 
			. communications and helpers for ACRE
		userconfig\ACRE\
			. hot-key configuration
	-- Teamspeak 3 Client\plugins\ Directory --
		ACRE.dll
			. TS3 plugin for 32-bit systems
		ACRE_x64.dll 
			. TS3 plugin for 64-bit systems
	
	-- Installation --
	1. Make sure TS3 and ArmA2 are not running
	2. Copy the contents of the ArmA2 directory into the root of your ArmA2 directory.
		. The ArmA2 root directory should now contain @ACRE, @JayArmA2Lib
	3. Copy the appropriate 32-bit or 64-bit ACRE DLL file into your Teamspeak 3 Client\plugins directory
	4. Within TeamSpeak 3, click Settings -> Plugins, and make sure ACRE is checked.
	5. Restart TeamSpeak 3
	6. Change your ArmA2 shortcut so the mod line contains at least: @cba;@JayArmA2Lib;@ACRE
	
	
--- Dedicated Server Installation --- 
A server side addon is also needed to run ACRE. This is due to the need to synchronize dropped radio's appropriately. However, the server ONLY required the @ACRE mod folder. It does *NOT* require JayArma2Lib. It is server compatible, but it is not required.
	
	1. Make sure the server is not running
	2. Copy the @ACRE folder into your ArmA2 folder
	3. Change your server shortcut so the mod line contains at least: @cba;@ACRE
	
	
--- Client Uninstall ---

Automatic Uninstall
	If you performed the automatic install, you can uninstall ACRE via your Control Panel uninstall menu.

Manual Uninstall 
	1. Make sure TS3 and ArmA2 are not running
	2. Delete ACRE.dll or ACRE_x64.dll from your TS3 Plugins Directory
	3. Delete the @acre, @JayArmA2Lib folders from your ArmA2 directory
	4. Remove @ACRE and @JayArmA2Lib from your mod line.

	
--- Server Uninstall ---

	1. Make sure the server is not running
	2. Delete the @acre folder in the ArmA2 Directory
	3. Remove @ACRE from your mod line.

	
--- Basic Instructions ---
	The Default Hot-Keys for ACRE Are as follows:
	
		CTRL + SHIFT + X 
			. Open your current radio GUI, if you have one
		CTRL + SHIFT + A
			. Hot-swap between the radios you are carrying as your active radio
		ALT  + SHIFT + Q
			. ACRE world interact key (used for interacting with other players or vehicles)
		ALT  + SHIFT + E
			. ACRE self interact key (used for interacting with your own radios, checking radio lists, etc)

		CAPSLOCK
			. Radio PTT(Push-To-Talk) Key
			
		** ALL OF THESE KEYS ARE CONFIGURATION VIA: ARMA 2\USERCONFIG\ACRE\ACRE_KEYS.HPP **
		
	-- Basic Usage --
	
	- Direct Speaking -
	Use your normal Teamspeak PTT Key, whatever you have configured it as. You will hear people move about you in 3D.
	
	- Radio Transmission -
	Whenever a person speaks or you yourself speak on a radio, you will hear two different types of 'squawks'. indicating both begin and end of transmission. Be careful! Transmitting at the same time as someone else creates feedback, and will make everyone listening angry. If you do not hear anything, that means you are out of range. Additionally, you will hear a background fuzz and distortion on a person speaking when they are on radio. Lastly, you can hear a person speak 'directly' when they speak on a radio, if you are not listening to that frequency. If you don't hear the distortion and buzz, that means you aren't receiving their radio transmission.
	
		Basic Operation
		1. If you're player has started with ItemRadio, it will automatically be replaced with a PRC-148
			2. If it is the only radio on you, it is active by default
			3. Press either CTRL+SHIFT+A to swap between active radios, or CTRL+SHIFT+V to view your radios
			4. Select the radio you want to use in step #3
			5. Press CNTRL+SHIFT+X, the Radio GUI will open
			6. Press ESC to leave the GUI
		
		AN/PRC-148
		1. click the UP and DOWN arrows on the radio
			. The channel and frequency will be displayed. Be on the same channel/frequency as someone else
		2. Press and HOLD your Radio PTT Key (CAPSLOCK)
			. You will hear a 'squawk', or beep, which indicates you are transmitting
		3. Say "I am a jolly Rodger"
		4. Let go of your Radio PTT Key (CAPSLOCK)
			. You will hear another 'squawk', or radio "cut", indicating you have stopped transmitting
		
		AN/PRC-119
			The AN/PRC-119 consists of multiple functions on the radio. Currently, some are not enabled. The functionality available as of right now is as follows:
* 6 pre-programmed channels
- You are able to click the knob to 'turn' it between channels
* Switching between power(PWR) modes. These are 400mW, 2200mW, 4000mW, and 40,000mW
- 40,000mW is "PA Mode", which is only available in vehicles
* Programming to a custom frequency for a channel or in manual mode
			
			In a simple scenario, you can simply click the channel knob, and you will be on those frequencies. If you wish to program a custom frequency, you can do the following:
			
			1. Click the 'CLR' button to clear the current frequency
			2. Program the 5-digit frequency you wish to use. 
				. Ex: if you want the frequency 3.111, this would be programmed by clicking: 0 - 3 - 1 - 1 - 1
			3. Click 'CTO' to use that frequency.

	
--- Thanks ---
- All the official ACRE testers
- UnitedOperations.Net Community for Testing
- Shack Tactical for multiple thorough testing session
- SSG Clan (www.ssg-clan.se) for so much thorough testing and dealing with crashes
- Dev-Heaven community for listening to us complain
- BI Forums community for the support
- kju & Sickboy for the dev-heaven space