================================
| CH M1Abrams Pack v1.2 ReadMe |
================================


This addon contains M1A1HC (Heavy Common) and M1 in several paint schemes
converted from ArmA 1 to ArmA 2. All models are based on ArmA 1 sample 
models released by BIS.


Latest changes:
--------------------------------------------------------------------------
  - addon binarized with official ArmA 2 tools
  - added super shaders to materials
  - fixed loaders M240 rate of fire
  - FLIR will work only when looking through sights
  - some other small fixes


Included files:
--------------------------------------------------------------------------
  - ch_m1abrams.pbo
  - ch_m1abrams.pbo.cht.bisign
  - ch_m1abrams_cfg.pbo
  - ch_m1abrams_cfg.pbo.cht.bisign
  - cht.bikey (for server admins)


Required addons:
--------------------------------------------------------------------------
Extended Eventhandlers from Community Base Addons pack.
BI Forums topic - http://forums.bistudio.com/showthread.php?t=78622


Installation:
--------------------------------------------------------------------------
Extract the @CH folder to your ArmA2 main installation folder and use any 
of the modfolders methods to launch it.

New Abrams tanks can be found under CH - BLUFOR faction, on the BLUFOR 
side, and CH - Independent faction, on the Independent side. On both sides 
they are under CH - Armored class.


Scripts:
--------------------------------------------------------------------------

----------------
Custom markings|
----------------

Tank markings can be changed by putting the following line in the init 
field of the vehicle:

	CH_Markings = [this,"n1","n2","t1","t2","t3_l","t3_r","t4","t5"] execVM"\ch_m1abrams_cfg\scripts\m1a1\markings.sqf";

-------------------------------------------------------------------------------------------------------------------------------------------------------------
Parameter   |   Selection number    |   Possible values	for M1A1				|  Possible values for M1				    |
-------------------------------------------------------------------------------------------------------------------------------------------------------------
  this	    |     -		    |     user defined (tank name)				|     user defined (tank name)				    |
  n1	    |     5		    |     00, 01, 02, 03, 04, 05, 06, 07, 08, 09, empty, random	|     00, 01, 02, 03, 04, 05, 06, 07, 08, 09, empty, random |
  n2	    |     6		    |     00, 01, 02, 03, 04, 05, 06, 07, 08, 09, empty, random	|     00, 01, 02, 03, 04, 05, 06, 07, 08, 09, empty, random |
  t1	    |     7		    |     00, 01, 02, 03,04,05,06,07,08,09, empty, random	|     empty						    |
  t2	    |     8		    |     00, 01, 02, 03,04,05,06,07,08,09,10, empty, random	|     empty						    |
  t3_l	    |     9		    |     00, empty						|     00, empty						    |
  t3_r	    |     10		    |     00, empty						|     00, empty						    |
  t4	    |     11		    |     00, 01, 02, 03,04,05,06,07,08,09,10,11, empty		|     empty						    |
  t5	    |     12		    |     00,01 empty						|     empty						    |
-------------------------------------------------------------------------------------------------------------------------------------------------------------

To set user made markings use the following syntax after mission start:

	TankName setObjectTexture [selection number,"TextureFile"];

see also: markings_m1a1.jpg, markings_m1.jpg, markings_sleections_m1a1.jpg, markings_sleections_m1.jpg


----------------
Custom textures|
----------------

To set user made textures use the following syntax after mission start:

	TankName setObjectTexture [0,"...\m1abrams_01_co.paa"];
	TankName setObjectTexture [1,"...\m1abrams_02_co.paa"];
	TankName setObjectTexture [2,"...\m1abrams_03_co.paa"];
	TankName setObjectTexture [3,"...\m1abrams_04_co.paa"];
	TankName setObjectTexture [4,"...\m1abrams_track_co.paa"];

see also: textures_sleections_m1a1.jpg, textures_sleections_m1.jpg


--------------------
Equipment on turret|
--------------------

It is possible to set different equipment layouts on tank turret. To do so 
put the following line in the init filed of the vehicle:

	CH_Stuff = [this,"stuff1"] execVM "\ch_m1abrams_cfg\scripts\m1a1\stuff.sqf";

-----------------------------------------------------------
Parameter   |   Possible values				  |
-----------------------------------------------------------
  this	    |     user defined (tank name)		  |
  stuff1    |     00, 01, 02, 03, 04, 05, empty, random	  |
-----------------------------------------------------------


-------------
Custom parts|
-------------

Some parts of the tank can be hided or unhided. To do so put the following 
line in the init filed of the vehicle:

	CH_Panc = [this,"panc1","panc2","panc3"] execVM "\ch_m1abrams_cfg\scripts\m1a1\panc.sqf";

----------------------------------------------------------------------------------------------------------------
Parameter   |   Possible values for M1A1  |   Possible values for M1  |   Description	  		       |
----------------------------------------------------------------------------------------------------------------
  this	    |     user defined	  	  |     user defined	      |     tank name	  		       |
  panc1     |     hide, unhide	  	  |     hide, unhide	      |     rear skirt plate  		       |
  panc2     |     hide, unhide	  	  |     -		      |     IFF panels on sides of the turret  |
  panc3     |     hide, unhide	  	  |     -		      |     IFF panels in front of the turret  |
----------------------------------------------------------------------------------------------------------------


--------------
Ammo loadouts|
--------------

It is possible to change default ammo loadouts via build-in script. To do 
so put the following line in the init filed of the vehicle:

	CH_Loadout = [this, "loadout1"] execVM "\ch_m1abrams_cfg\scripts\m1a1\loadout.sqf";

-----------------------------------------------------------------------------
Parameter   |   Possible values for M1A1    |   Possible values for M1      |
-----------------------------------------------------------------------------
  this	    |     user defined (tank name)  |     user defined (tank name)  |
  loadout1  |     anti-tank, anti-personnel |     default	      	    | 
-----------------------------------------------------------------------------


Class names:
--------------------------------------------------------------------------

---------
Vehicles|
---------

-----------------------------------------------------------
Vehicle		   | Class name		 | Side		  |
-----------------------------------------------------------
  M1A1HC	   |   CH_M1A1HC	 |   BLUFOR	  |
  M1A1HC (NATO)	   |   CH_M1A1HC_NATO	 |   BLUFOR	  |
  M1A1HC (Desert)  |   CH_M1A1HC_DESERT	 |   BLUFOR	  |
  M1		   |   CH_M1		 |   BLUFOR	  |
  M1 (Green)	   |   CH_M1_GREEN	 |   BLUFOR	  |
  M1 (REFORGER 83) |   CH_M1_REFORGER83	 |   BLUFOR	  |
  M1 (MERDC)	   |   CH_M1_MERDC	 |   BLUFOR	  |
  M1		   |   CH_M1_GUER	 |   Independent  |
  M1 (RACS)	   |   CH_M1_RACS	 |   Independent  |
-----------------------------------------------------------


----------------------
Weapons and magazines|
----------------------

------------------------------------------------------------------------------------------------------------------------------
Weapon		   | Class name		    | Supported magazines 							     |
------------------------------------------------------------------------------------------------------------------------------
  M256		   |   CH_M256_M1A1	    |   CH_27Rnd_M829A2, CH_3Rnd_M830A1, CH_13Rnd_M830A1, CH_2Rnd_M830, CH_5Rnd_M908 |
  M68A1		   |   CH_M68A1_M1	    |   CH_30Rnd_M735, CH_25Rnd_M456, CH_20Rnd_M392A2, CH_15Rnd_M393A1 	             |
  M240C		   |   CH_M240C_veh_M1A1    |   CH_2800Rnd_762x51_M240	      						     |
  M240		   |   CH_M240_loader_M1A1  |   CH_200Rnd_762x51_M240					      		     |
  M240B		   |   CH_M240B_loader_M1A1 |   CH_200Rnd_762x51_M240							     |
  M2HB		   |   CH_M2_M1A1	    |   CH_100Rnd_127x99_M2							     |
------------------------------------------------------------------------------------------------------------------------------


Credits:
--------------------------------------------------------------------------

***People mainly responsible for this addon***

	Mateck - model tweaks, textures, configs
	T_Bone - textures
	Crazy Hussars Team - beta testers


***Special thanks***

	Gachopin - for his FLIR script for ArmA 2
	RobertHammer - for M240s and M2 sounds
	Apache-Cobra - for IFF panel model
	NonWonderDog - for great resource of ammo and armor values
	Xeno - for smoke screen script
	XAM Team - for the idea of FLIR script
	BIS - for ArmA itself and for releasing sample models

	...and many other community members for help and support