Franze's Su-17 pack v ALPHA 0.1 for ArmA2:CO v1.59
------------------------------------------
DISCLAIMER: If any damage occurs while using this addon, you cannot hold me responsible.
I cannot be held at fault if you have a strong desire for a shot of vodka afer using
this addon.

Use at your own risk!

------------
Introduction
------------
This is an ALPHA package of my Su-17, and as such is considered INCOMPLETE with many
bugs and 'undocumented' features. This addon should in no way be considered a final
product!

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

To ArmA2\Addons folder:
fza_an12.pbo (An-12B)
fza_mig23mld.pbo (MiG-23MLD)
fza_su17.pbo (Su-17/22M4)

To ArmA2\Missions folder:
Missions\ (single missions)

To UserProfile\Missions folder:
fza_su17_example.utes (reference mission for functions)

--------
Overview
--------
Here is an overview of features and
requirements for usage:

- To use arming menu, you must be within 50m of a Ural Ammo truck at a complete stop.

- The Su-17 action menu has the majority of actions in cyrillic, but the Su-22 has all
actions in english. Some actions are bound to keys - Select Handgun will cycle the ASP-17
sight mode; binoculars will deploy drag chute; and vehicle turbo will engage afterburner.

- For maximum performance, place a Su-17 Weapons unit (OPFOR>RU>FZA Aircraft and BLUFOR>FZA - Poland>FZA Aircraft) with the name
"fz_weaponcmd_east" ("fz_weaponcmd" for Polish Su-22) on the map. This gives a group assignment
for the weapon proxies and preloads the proxy units, which helps game performance. This unit is
required for a dedicated server. Preloading the K-36 ejection seat, Su-17 canopy, and drag chute
are also recommended.

- Steerpoints - the HSI compass has the ability to use steerpoints, custom points created
for navigation. These are separate from waypoints in that they simply indicate a
direction to a destination and are specific to one unit. The AI has no need for these,
they are simply an aid for human pilots. To use, open the steerpoint control menu, then
use the "create steerpoints" action, then go to the map and click on the map to create
steerpoints. When you are satisfied with your steerpoint route, either use the
"save steerpoints" action or "close steerpoint control" to lock the steerpoints. If you
want to create a new set of steerpoints, use the "clear steerpoints" action. You cannot
add steerpoints while in flight, only cycle them.

- Wing sweep - wing sweep is done manually in the Su-17. With no sweep, you can use your
flaps, but the maximum speed of the aircraft is limited. Half sweep, you lose flap
control but gain speed while using afterburners. With maximum sweep, you can attain
a maximum speed of roughly 1400kmh.

- Drop tanks - The drop tanks on the Su-17 will feed the aircraft until
they run empty, at which point the aircraft runs off of internal tanks. Drop tank fuel
quantity is indicated on the #2 needle on the fuel gauge. A maximum of 3200 liters of
external fuel can be carried. Internal fuel capacity is 4900 liters.

- CCIP sight on ASP-17 - This is NOT a reliable sighting system! It is still being
debugged and implemented. Cycle the sighting modes with the "handgun" key.

- Klen TV Camera and Klen Laser Designator - Use the numpad arrow keys to pan the camera
up, down, left, and right. Use the throttle or Q and Z keys to control zoom (TV mode
only). Move the crosshairs/target over the desired objective and hit the V key to
designate it. The "Klen Target" will remain active until the object is destroyed. If there
is no object within a certain radius, the target remains active for 2 minutes, then
expires. You cannot employ weapons until a target has been designated, and the TV mode
forces the aircraft into an altitude and attitude hold until finished.

- Laser guided weapons - the Kh-25ML, Kh-29L, and S-25L require the laser to be on before
firing. Failure to turn the laser on will result in the missiles going terminal.

------------------
Project Background
------------------

The Su-17 project was started in summer of '08. The intention was to create a fighter-bomber
that could adequately be explained away for SLA usage in ArmA. Given the Su-17's real world
status as a cheap, dependable, and rugged fighter-bomber, it worked out well for that purpose.
In ArmA2 it could potentially have a far more wider range of uses given the Former Soviet
Union presence; however, I have not had the time to develop it to full effect. Here is what
it has so far - not many changes from the ArmA1 version:

- 'working' CCIP system for bombs and rockets - this isn't as finalized as we'd like, as it's
a very inaccurate system, but it's adequate enough for most bombing purposes.

- Steerpoint system - steerpoints are similar to waypoints, but steerpoints are controlled by
the aircraft's combined compass-HSI. The compass will point to the next steerpoint in a list
created by the pilot. Not too useful on small maps but it was designed with the Kurilekia map
in mind.

- ELINT system - ELINT stands for ELectronic INTelligence. The Su-17 can use the KKR
camera-ELINT-flare pod to pick up enemy radar and radiation signatures within 5km of the
aircraft. These targets are then marked for all flights as radiation targets which can be
acquired with the BR-58 tracking pod. Kh-25MP and Kh-58 missiles can be used to take out
these targets from a great distance.

- Improved missile spoofing - if missiles are fired at the Su-17, it's no longer an odd cycle
and abrupt turn. Missiles are 'fooled' an amount depending on certain conditions (i.e., aircraft
has flares, aircraft has SPS pod) and are more effective from frontal and rear arcs. Beaming the
missile (putting it on your flanks) has an effect now.

- Visual damage system - When hit and damage occurs, it will appear on the external model. Debris
will fly out and parts become damaged/destroyed. Aircraft handling is adversely affected and some
systems will quit working.

- Improved cluster bombs - cluster bombs will disperse their munitions along the axis of their
motion now.

- Klen TV/Laser targeting - You can use the aircraft's Klen laser designation system to mark
targets that are otherwise inactive/not acquireable.

- Dynamic arming - Get near an ammo truck or unit defined for rearming and a rearming dialog
becomes available. 

There are many other features but I've lost track of all of them; this is considered an alpha
version which I will try to keep updated as time goes on.

-------------
Known Issues
-------------
- Cockpit is not finished
- AI will try to board weapon positions
- Damage causes 'stutters' in aircraft motion due to ArmA2 scripting limitations
- Probably tons of other problems that I haven't fixed yet

------------------
Switches and Names
------------------
fz_weaponcmd_east - Group unit for east weapon proxies.
fz_weaponcmd - Group unit for west weapon proxies.

fza_su17_kkr_cam_array - Positional array for camera data. To manually add camera positions:
fza_su17_kkr_cam_array = [[0,0,0],[100,100,0]]

fza_su17_armarray - Anti-Radiation Missile target array. To add targets to the array:
fza_su17_armarray = [sam1,aaa2,ewr3,vulcan4]
(NOTE: Highly recommended to define this array for multiplayer scenarios.)

fza_su17_aaa_list - List of targets the ELINT system will detect. Default is:
fza_su17_aaa_list = ["Vulcan","Vulcan_RACS","ZSU"]
(NOTE: Highly recommended to define this array for multiplayer scenarios.)

fza_su17_nukecode - Nuclear weapons code. NOT case sensitive. To use:
fza_su17_nukecode = "nuke"

fza_su17_armingunits = [(typeof truck1),(typeof truck2)] - Designates the type of vehicles that
allow arming

fza_su17_aaa_list = ["Vulcan","Vulcan_RACS","ZSU",(typeof ewr1),(typeof sam2)] - Designates classes
of units that will be picked up by KKR ELINT scanner

fza_su17_armarray = [rwr1,sam2,sam3,vulcan4] 	Units that can be targeted by radiation pod

fza_su17_custskin = ["empty","\fza_su17\su17_skin_metal.paa"] - Custom skin array for the first
skin (wings)

fza_su17_custskin2 = ["empty","\fza_su17\su17_skin2_metal.paa"] - Custom skin array for the second
skin (fuselage)

fza_su17_steerpointdata = [(getpos player),(getpos obj1),[200,100],(getpos obj2)] - Steerpoint data
array (position 2D)

fza_su17_nukecode = "chuckskinorriski" - Nuclear weapons authorization code

fza_su17_noreplenishloads = 1 - Discards weapons after reloading

fza_su17_norandomnumbers = 1 - Turns off random numbers

fza_su17_camodroptanks = 1 - Droptanks camouflaged switch

fza_su17_camodroptanks = 2 - Use custom drop tank texture

fza_su17_custtanks = "texturename" - Custom drop tank texture string

fza_su17_kkr_cam_array = [(getpos obj1),[100,100,300]] - KKR camera photo array (position 3D)

this animate ["skin_sw",0.01] - Used in Su-17 init field, sets which skin to use in the custom skin array
(0.01 would be the SECOND defined skin - the FIRST is NEVER used)

this setobjecttexture [67,"\fza_su17\num\ext_red1.paa"] - Sets the far left number to Red 1
(custom numbering only)

this setobjecttexture [68,"\fza_su17\num\ext_red1.paa"] - Sets the second from left number to Red 1
(custom numbering only)

this setobjecttexture [69,"\fza_su17\num\ext_red4.paa"] - Sets the third from left number to Red 4
(custom numbering only)

this setobjecttexture [70,"\fza_su17\num\ext_red1.paa"] - Sets the fourth from left number to Red 1
(custom numbering only)

this animate ["droptank_sw",0.5] - Sets the individual Su-17 to use the defined custom tank texture

this animate ["droptank_sw",1] - Sets the individual Su-17 to use camouflaged drop tanks

------------------------
Weapon Limits Parameters
------------------------
 
fza_su17_overallstoreslimit = x Limits all stores.
fza_su17_fab100_count = x 	Limits the number of FAB-100 on MER available.
fza_su17_fab250x2_count = x 	Limits the number of FAB-250 on single racks available.
fza_su17_fab250x6_count = x 	Limits the number of FAB-250 on MER available.
fza_su17_fab500_count = x 	Limits the number of FAB-500 available.
fza_su17_rbk250x2_count = x 	Limits the number of RBK-250 on single racks available.
fza_su17_rbk250x6_count = x 	Limits the number of RBK-250 on MER available.
fza_su17_rbk500_count = x 	Limits the number of RBK-500 available.
fza_su17_kmgu_count = x 	Limits the number of KMGU-2 available.
fza_su17_kab500kr_count = x 	Limits the number of KAB-500Kr available.
fza_su17_ub32m_count = x 	Limits the number of UB-32M pods available.
fza_su17_b8m1_count = x 	Limits the number of B-8M1 pods available.
fza_su17_b13l_count = x 	Limits the number of B-13L pods available.
fza_su17_s24_count = x 		Limits the number of S-24 rockets available.
fza_su17_s25_count = x 		Limits the number of S-25 rockets available.
fza_su17_s25l_count = x 	Limits the number of S-25L rockets available.
fza_su17_kh25ml_count = x 	Limits the number of Kh-25ML missiles available.
fza_su17_kh25mp_count = x 	Limits the number of Kh-25MP missiles available.
fza_su17_kh25mr_count = x 	Limits the number of Kh-25MR missiles available.
fza_su17_kh29l_count = x 	Limits the number of Kh-29L missiles available.
fza_su17_kh58_count = x 	Limits the number of Kh-58 missiles available.
fza_su17_r60m_count = x 	Limits the number of R-60M missiles available.
fza_su17_sppu22_count = x 	Limits the number of SPPU-22 (GSh-23L) pods available.
fza_su17_ba58_count = x 	Limits the number of BA-58 pods available.
fza_su17_delta_count = x 	Limits the number of DELTA pods available.
fza_su17_sps_count = x 		Limits the number of SPS pods available.
fza_su17_kkr_count = x 		Limits the number of KKR pods available.
fza_su17_800l_count = x 	Limits the number of 800l fuel tanks available.

------------------
Vehicle Classnames
------------------

fza_su17m4 	Su-17M4 aircraft
fza_su22m4 	Su-22M4 aircraft
fza_su17m4_w 	Su-22M4 (Western, NATO Polish colors)
fza_su17weps 	Su-17 Weapons unit
fza_su17weps_w 	Su-17 Weapons unit (west)
fza_su17_k36seat 	K-36 ejection seat
fza_su17m4_dragchute 	Drag chute
fza_su17m4_canopy 	Su-17 Canopy
fza_su17_cam 	KKR Cam spotter object
fza_su17_camtent 	Photography tent for viewing camera data
fza_su17_gantry 	Gantry object for cutscenes
fza_su17_raft 	Soviet life raft
fza_mig23mld 	MiG-23MLD
fza_mig23mld_guer 	MiG-23MLD (Guerilla)
fza_mig23mld_west 	MiG-23MLD (West)
fza_an12b 	An-12B

-----------------
Weapon Classnames
-----------------

If a weapon has a ## at the end, that indicates the following numbers can be used:
16, 25, 34, 78, 12
If it has a xx at the end, the following numbers can be used:
16, 25, 34
If it has yy at the end, the following numbers can be used:
16, 25, 12
If it has zz at the end, the following numbers can be used:
16, 25
Weapon 	Magazines 	Description
fza_su17_nr30 	fza_su17_nr30, fza_su17_nr30_ap 	NR-30 30mm cannon, HE magazine, AP magazine
fza_su17_sppu22_xx 	fza_su17_sppu22_xx 	SPPU-22 GSh-23 gunpod
fza_su17_sppu22_all 	fza_su17_sppu22_all 	SPPU-22 GSh-23 gunpod, combined
fza_su17_r60m_2 	fza_su17_r60m_2 	R-60M Aphid missiles
fza_su17_kh25ml_xx 	fza_su17_kh25ml_xx 	Kh-25ML Missiles
fza_su17_kh25mp_xx 	fza_su17_kh25mp_xx 	Kh-25MP Missiles
fza_su17_kh25mr_xx 	fza_su17_kh25mr_xx 	Kh-25MR Missiles
fza_su17_kh58_34 	fza_su17_kh58_34 	Kh-58 Missiles (Stations 3 and 4 only)
fza_su17_kh29l_zz 	fza_su17_kh29l_zz 	Kh-29L Missiles
fza_su17_kmgu_yy 	fza_su17_kmgu_yy 	KMGU-2 Dispensers
fza_su17_kkr 	fza_su17_kkr 	KKR Flare dispenser
fza_su17_kkr_cam 	fza_su17_kkr_cam 	KKR Camera weapon
fza_su17_fab100x8_yy 	fza_su17_fab100x8_yy 	FAB-100x8 on MER racks
fza_su17_fab250 	fza_su17_fab250 	FAB-250x2 for stations 3 & 4
fza_su17_fab250_## 	fza_su17_fab250_## 	FAB-250x2 bombs
fza_su17_fab250x6_yy 	fza_su17_fab250x6_yy 	FAB-250x6 on MER racks
fza_su17_rbk250_## 	fza_su17_rbk250_## 	RBK-250x2 bombs
fza_su17_rbk250x6_yy 	fza_su17_rbk250x6_yy 	RBK-250x6 on MER racks
fza_su17_fab500 	fza_su17_fab500 	FAB-500x2 for stations 1 & 6
fza_su17_fab500_## 	fza_su17_fab500_## 	FAB-500x2 bombs
fza_su17_rbk500_## 	fza_su17_rbk500_## 	RBK-500x2 bombs
fza_su17_kab500kr_yy 	fza_su17_kab500kr_yy 	KAB-500Kr x2 bombs
fza_su17_ub32mx64 	fza_su17_ub32mx64 	UB-32Mx2 for stations 2 & 5
fza_su17_ub32mx64_xx 	fza_su17_ub32mx64_xx 	UB-32Mx2 rocket pods
fza_su17_ub32mx32_5 	fza_su17_ub32mx32_5 	UB-32Mx1 rocket pod for use with DELTA pod
fza_su17_s24_xx 	fza_su17_s24_xx 	S-24x2 rockets
fza_su17_s25_xx 	fza_su17_s25_xx, fza_su17_s25l_xx 	S-25x2 rockets, S-25Lx2 rockets
fza_su17_b8m1x40_xx 	fza_su17_b8m1x40_xx 	B-8M1x2 rocket pods
fza_su17_b8m1x20_5 	fza_su17_b8m1x20_5 	B-8M1x1 rocket pod for use with SPS pod
fza_su17_b13x10_xx 	fza_su17_b13x10_xx 	B-13x2 rocket pods
fza_mig23mld_gsh23l 	fza_mig23mld_gsh23l 	GSh-23L for MiG-23
fza_mig23mld_r24r_2 	fza_mig23mld_r24r_2 	R-24R Missiles for MiG-23
fza_mig23mld_r60m_4 	fza_mig23mld_r60m_4 	R-60M missiles for MiG-23

---------------------
Cyrillic translations
---------------------

Су-17 - Su-17
Су-17М4 - Su-17M4
НР-30 30мм - NR-30 30mm
Р-60М Комар - R-60M "Gnat"
С-5 57мм ОН - S-5 57mm HE
С-8 80мм ОН - S-8 80mm HE
УБ-32М 57мм ОН Станция 5 и 6 - UB-32M 57mm HE Station 5 and 6
УБ-32М 57мм ОН x2 Станция 5 и 6 - UB-32M 57mm HE Station 5 and 6
УБ-32М 57мм ОН x4 Станция 5 и 6 - UB-32M 57mm HE Station 5 and 6
УБ-32М 57мм ОН Станция 1R и 2R  - UB-32M 57mm HE Station 1R and 2R
УБ-32М 57мм ОН x2 Станция 1R и 2R  - UB-32M 57mm HE Station 1R and 2R
УБ-32М 57мм ОН x4 Станция 1R и 2R  - UB-32M 57mm HE Station 1R and 2R
УБ-32М 57мм ОН Станция 3 и 4  - UB-32M 57mm HE Station 3 and 4
УБ-32М 57мм ОН x2 Станция 3 и 4  - UB-32M 57mm HE Station 3 and 4
УБ-32М 57мм ОН x4 Станция 3 и 4  - UB-32M 57mm HE Station 3 and 4
Б-8М1 80мм ОН x2 Станция 3 и 4   - B-8M1 80mm HE Station 3 and 4
Б-8М1 80мм ОН x4 Станция 3 и 4   - B-8M1 80mm HE Station 3 and 4
Б-8М1 80мм ОН x2 Станция 1R и 2R   - B-8M1 80mm HE Station 1R and 2R
Б-8М1 80мм ОН x4 Станция 1R и 2R   - B-8M1 80mm HE Station 1R and 2R
Б-8М1 80мм ОН x2 Станция 5 и 6   - B-8M1 80mm HE Station 5 and 6
Б-8М1 80мм ОН x4 Станция 5 и 6   - B-8M1 80mm HE Station 5 and 6
С-24 240мм - S-24 240mm
С-24 240мм ОН x1 Станция 3 и 4 - S-24 240mm Station 3 and 4
С-24 240мм ОН x1 Станция 5 и 6 - S-24 240mm Station 5 and 6
С-24 240мм ОН x1 Станция 1R и 2R - S-24 240mm Station 1R and 2R
С-25 340мм  - S-25 340mm
С-25 340мм ОН x1 Станция 3 и 4 - S-25 340mm Station 3 and 4
С-25 340мм ОН x1 Станция 5 и 6 - S-25 340mm Station 5 and 6
С-25 340мм ОН x1 Станция 1R и 2R - S-25 340mm Station 1R and 2R
С-13 122мм - S-13 122mm
Б-13Л 122мм ОН x1 Станция 3 и 4 - B-13L 122mm Station 3 and 4
Б-13Л 122мм ОН x1 Станция 5 и 6 - B-13L 122mm Station 5 and 6
Б-13Л 122мм ОН x1 Станция 1R и 2R - B-13L 122mm Station 1R and 2R
КМГУ-2 Станция 3 и 4 - KMGU-2 Station 3 and 4
КМГУ-2 Станция 5 и 6 - KMGU-2 Station 5 and 6
КМГУ-2 Станция 1С и 2С - KMGU-2 Station 1S and 2S
ФАБ-100 - FAB-100
ФАБ-100 Станция 3 и 4 - FAB-100 Station 3 and 4
ФАБ-100 Станция 5 и 6 - FAB-100 Station 5 and 6
ФАБ-100 Станция 1С и 2С - FAB-100 Station 1S and 2S
ФАБ-250 Станция 1 и 2 - FAB-250 Station 1 and 2
ФАБ-250 Станция 1С и 2С - FAB-250 Station 1S and 2S
ФАБ-250 Станция 3 и 4 - FAB-250 Station 3 and 4
ФАБ-250 Станция 5 и 6 - FAB-250 Station 5 and 6
ФАБ-250 Станция 7 и 8 - FAB-250 Station 7 and 8
РБК-250 Станция 1 и 2 - RBK-250 Station 1 and 2
РБК-250 Станция 1С и 2С - RBK-250 Station 1S and 2S
РБК-250 Станция 3 и 4 - RBK-250 Station 3 and 4
РБК-250 Станция 5 и 6 - RBK-250 Station 5 and 6
РБК-250 Станция 7 и 8 - RBK-250 Station 7 and 8
ФАБ-500 Станция 3 и 4 - FAB-500 Station 3 and 4
ФАБ-500 Станция 5 и 6 - FAB-500 Station 5 and 6
ФАБ-500 Станция 1R и 2R - FAB-500 Station 1R and 2R
ФАБ-500 Станция 7 и 8 - FAB-500 Station 7 and 8
РБК-500 - RBK-500
РБК-500 Станция 1 и 2 - RBK-500 Station 1 and 2
РБК-500 Станция 3 и 4 - RBK-500 Station 3 and 4
РБК-500 Станция 5 и 6 - RBK-500 Station 5 and 6
РБК-500 Станция 7 и 8 - RBK-500 Station 7 and 8
КАБ-500Кр Станция 5 и 6 - KAB-500Kr Station 5 and 6
КАБ-500Кр Станция 1 и 2 - KAB-500Kr Station 1 and 2
КАБ-500Кр Станция 3 и 4 - KAB-500Kr Station 3 and 4
ЕТ-1000 Станция 5 и 6 - TN-1000 Station 5 and 6
Кh-25МЛ - Kh-25ML
Кh-25МЛ Станция 3 и 4 - Kh-25ML Station 3 and 4
Кh-25МП Станция 3 и 4 - Kh-25MP Station 3 and 4
Кh-25МP Станция 3 и 4 - Kh-25MR Station 3 and 4
Кh-25МЛ Станция 1R и 2R - Kh-25ML Station 1R and 2R
Кh-25МП Станция 1R и 2R - Kh-25MP Station 1R and 2R
Кh-25МP Станция 1R и 2R - Kh-25MR Station 1R and 2R
Кh-25МЛ Станция 5 и 6 - Kh-25ML Station 5 and 6
Кh-25МП Станция 5 и 6 - Kh-25MP Station 5 and 6
Кh-25МP Станция 5 и 6 - Kh-25MR Station 5 and 6
Кh-58 Станция 1R и 2R - Kh-58 Station 1R and 2R
Кh-29Л - Kh-29L
Кh-29Л Станция 3 и 4 - Kh-29L Station 3 and 4
Кh-29Л Станция 5 и 6 - Kh-29L Station 5 and 6
ГШ-23 - GSh-23
ГШ-23 Станция 3 и 4 - GSh-23 Station 3 and 4
ГШ-23 Станция 5 и 6 - GSh-23 Station 5 and 6
ГШ-23 Станция 1R и 2R - GSh-23 Station 1R and 2R
ККP ПИРОФАКЕЛА - KKR Flare
ККP КАМЕРЫ - KKR Camera
ПРЕДУПРЕЖДЕНИЕ! КАТАПУЛЬТИРУЕМОЕ СИДЕНЬЕ - Ejection Seat
Увеличить стреловидность крыла - Increase Wing Sweep
Уменьшить стреловидность крыла - Decrease Wing Sweep
Открыть фонарь - Open Canopy
Закрыть фонарь - Close Canopy
Выпустить Шасси - Gear Up
Поднять Шасси - Gear Down
Форсаж включен - Afterburner on
Форсаж выключен - Afterburner off
сброс баков - Drop tanks
выпуск тормозного парашюта - Drag chute
Отрегулируйте Пушка Визирование - Gunsight mode
Радиация Обозначение - Target radiation unit
Радиация Обнаружьте - Scan for radiation targets
Электронные противосредства позволяют - ECM on
Электронные противосредства Конец - ECM off
Лазерная Включено - Laser On
Лазерная Отключить - Laser Off
Клен ТВ Назначение - Klen TV targeting
Клен лазерный целеуказатель - Klen Laser targeting

-------
Credits
-------
Franze (modeling, texturing, scripting)

Nodunit (ZiL-157 model and texture)

General Barron (getpitch, getbank, setpitch, setbank functions)

Footmunch (afterburner script)

Gaia/Xenom (nuclear blast script)

Gedis (provided information sources on Su-17)

Hellcat (testing)

--------------
Special Thanks
--------------

Col Klink - Many scripting concepts based upon his work

CrazyIvan - Cyrillic/Russian translations
