Addon Name: DPM Troop Pack 1
Version: 1.1
By: Project UK Forces (http://www.project-ukf.com)
Contact E-mail: contact@project-ukf.com
Requires: OFP version 1.94, JAM2

CONTENTS
=========
1. Design Team
2. Version History
3. Addon Description
4. Installation
5. Known Issues
6. Units & Class names
7. Commands And Features
8. Glossary
9. Appendix A
10. Final Word



1. DESIGN TEAM
=============

Project Leaders:	Jonno, Mav
Units Models:           Jonno, Bohemia Interactive Studio (BIS)
Weapons Models:	        FatJoe
Mapping: 	        Jonno
Textures: 		Jonno
Scripts:		Vade 101, Tom Norman
Cpp Files: 	        Vade 101 
Animations:             Gameer
Advisors: 	        Woofer, Huey, Mav, Wrighty, Choochoo, JB
Beta Testers: 	        JB, Cpl.Punishment, Kooky, Jackal326, Jonngo-lightly, Ash, kevbaz,                
                        Pathfinder, Volcbat (http://volcbat.co.uk) and all the UKF team.

Special Thanks to: 
Bibmi, for the original inspiration for the Project, and for founding Project UK Forces. 
Earl and Suchey, for their 5.56mm LMG (minimi). 
KMARNS, for their International Soldier Model and Scripts and L7A2 GPMG model.
Chris330 for the LAW80 model and textures. 
TJ, DeadMeat, Ebud, Dinger and Killswitch for their assistance and technical advise.
Bohemia Interactive Studio, for giving the world Operation Flashpoint.

2. VERSION HISTORY
=================
1.0 24/05/04
- 
1.1 30/09/04
-fixed: error message when ai law80 units attach bayonets
-fixed: units freeze occasionally after the bayonet stabbing animation has played
-fixed: SA80 model altering its lighting upon fixing the bayonet
-fixed: Bayonet commands multiplying in the action menu when entering and exiting vehicles 
-fixed: multiple expended laws dropped by player, in multi player
-fixed: duplicate ECP event handlers removed
-fixed: Clansman compatibility with CoC Arty1.0
-fixed: corrected NBC respirator pouch texture & model


3. ADDON DESCRIPTION
===================
This addon provides the gamer with a set of Infantry, comprehensively researched, modelled and textured to be as accurate as possible in every respect. Included in this pack are a generic regiment, wearing blue berets, the Parachute Regiment and the Royal Marines. Unless stated, everything is Project UKF's own work.

Features include:-

- Highly accurate and comprehensively researched Infantry units in DPM.
- The latest weapons and equipment as used by the British Army.
- Interchangeable headgear & extra equipment.
- Animated goggles.
- Working, accurately calibrated UGL sights.
- One shot expendable LAW80
- Working Bayonets


4. INSTALLATION
=============
OFP Version 1.94 Beta or higher and JAM2 are both required to run this addon.
Place these files in your res/addons folder:
ukf_infantry.pbo
ukf_rm.pbo
ukf_para.pbo
ukf_ukweps
ukf_slmg.pbo
ukf_textuk.pbo

5. KNOWN ISSUES
===============
- After picking up a LAW80 off the ground and firing it, the fix bayonet command will not work, however if you drop the SA80 then pick it back up it will work again. (this caused much of a delay in release) If you start with a LAW80 it works fine untill you pick up another LAW80.
- Headgear and packs reseting upon loading a save game, thankfully saving is not a commom occurance in OFP. 





6. UNITS & CLASS NAMES
=====================

6a. Weapons
============

 
Weapon Name	Magazine(s)	Description	   
			   
UKF_SA80	JAM_W556_30mag		L85A2 ICW	   
UKF_SA80AG36	JAM_W556_30mag, JAM_M433grenade,
JAM_M433Vest, JAM_M576buck,
JAM_MarkerGrenades, JAM_MarkerRound,
JAM_flareWhite,
JAM_flareGreen,
JAM_FlareRed, JAM_FlareYellow	L85A2 ICW With 
UGL (H&K AG36)	   
UKF_LSW	JAM_W556_L86_30mag, JAM_W556_30mag	L86A2 LSW	   
UKF_LMG	JAM_W556M_200mag	LMG (FN Minimi Para)	   
UKF_GPMG	JAM_W762M_100mag	GPMG (Modified FN MAG)	   
UKF_LAW80Launcher	ukf_LAW80,	LAW80	   
			   
UKF_CLANSMAN	Clansman Radio		 


						
	
					
6b. Units
==========

Unit Name			Class Name	 	Description
============		===========	===========
Infantry
========
DPM Rifleman		ukf_infantryWBb	Standard Infantry Rifleman with PLCE webbing and SA80
DPM Rifleman (Assualt Vest)	ukf_infantryWBv	Standard Infantry Rifleman with Assualt Vest and SA80
DPM Rifleman (Chest Rig)	ukf_infantryWBr	Standard Infantry Rifleman with Chest Rig and SA80
DPM Officer			ukf_infantry_officerWBb	Infantry Officer with SA80, NVGs and Binoculars
DPM Rifleman (LAW-80)		ukf_infantry_lawWBb	Standard Infantry Rifleman with SA80 and LAW80
DPM Rifleman (SA80/UGL)	ukf_infantry_rlgWBb	Standard Infantry Rifleman with SA80 and UGL
DPM Support (LSW)		ukf_infantry_lswWBb	Infantry Support with LSW	
DPM Support (LMG)		ukf_infantry_LMGWBb	Infantry Support with LMG
DPM Machine Gunner (GPMG)	ukf_infantry_gmpgaWBb	Machine Gunner with GPMG
DPM Asst. Machine Gunner (GPMG) ukf_infantry_gmpgbWBb	Assistant Machine Gunner with GPMG ammo and SA80
DPM Signaller		ukf_infantry_radioWBb	Infantry Signaller with SA80 and Clansman Radio
DPM Medic			ukf_medicWBb	Field Medic with SA80

Parachute Regiment
==================
DPM Rifleman		ukf_para_WBb	Parachute Regt. Rifleman with PLCE webbing and SA80
DPM Rifleman (Assualt Vest)	ukf_para_WBv	Parachute Regt. Rifleman with Assualt Vest and SA80
DPM Officer			ukf_para_OfficerWBb	Parachute Regt. Officer with SA80, NVGs and Binoculars
DPM Rifleman (LAW-80)		ukf_para_lawWBb	Parachute Regt. Rifleman with SA80 and LAW80
DPM Rifleman (SA80/UGL)	ukf_para_agWBb	Parachute Regt. Rifleman with SA80 and UGL
DPM Support (LSW)		ukf_para_lswWB	Parachute Regt. Support with LSW	
DPM Support (LMG)		ukf_para_sawWB	Parachute Regt. Support with LMG
DPM Machine Gunner (GPMG)	ukf_para_gmpgaWBh	Parachute Regt. Machine Gunner with GPMG
DPM Asst. Machine Gunner (GPMG) ukf_para_gmpgbWBh	Parachute Regt. Asst. M/Gunner W/. GPMG ammo and SA80
DPM Signaller		ukf_para_radioWBb	Parachute Regt. Signaller with SA80 and Clansman Radio
DPM Medic			ukf_para_medicWBb	Parachute Regt. Field Medic with SA80

Royal Marines
==============
DPM Rifleman		ukf_RM_WBb	Royal Marines Rifleman with PLCE webbing and SA80
DPM Rifleman (Assualt Vest)	ukf_rm_WBv		Royal Marines Rifleman with Assualt Vest and SA80
DPM Officer			ukf_rm_OfficerWBb	Royal Marines Officer with SA80, NVGs and Binoculars
DPM Rifleman (LAW-80)		ukf_rm_lawWBb	Royal Marines Rifleman with SA80 and LAW80
DPM Rifleman (SA80/UGL)	ukf_rm_agWBb	Royal Marines Rifleman with SA80 and UGL
DPM Support (LSW)		ukf_rm_lswWB	Royal Marines Support with LSW	
DPM Support (LMG)		ukf_rm_sawWB	Royal Marines Support with LMG
DPM Machine Gunner (GPMG)	ukf_rm_gmpgaWBh	Royal Marines Machine Gunner with GPMG
DPM Asst. Machine Gunner (GPMG) ukf_rm_gmpgbWBh	Royal Marines Asst. M/Gunner w/. GPMG ammo and SA80
DPM Signaller		ukf_rm_radioWBb	Royal Marines Signaller with SA80 and Clansman Radio
DPM Medic			ukf_rm_medicWBb	Royal Marines Field Medic with SA80



6c.Groups
==========

UKF British Infantry (DPM)
==========================
DPM Platoon Command Section	(3 men: 3 x SA80 1 x Clansman)	Platoon HQ (with Medic)
DPM Rifle Company Squad	(8 men: 5 x SA80 2 x LSW 1 x SA80/UGL 1 X LAW80)	Standard Rifle Section
DPM Rifle Company Squad (LMG) 	(8 men: 4 x SA80 2 x LSW 1 x SA80/UGL 1 X LMG 1 X LAW80)	Rifle Section with LMG
DPM Manouvre Support Section 	(5 men: 3 x SA80 2 x GPMG)	Manouvere Support Section 

Parachute Regiment
==========================
DPM Platoon Command Section	(3 men: 3 x SA80 1 x Clansman)	Platoon HQ (with Medic)
DPM Rifle Company Squad	(8 men: 4 x SA80 2 x LSW 1 x SA80/UGL 1 x LMG 1 X LAW80)	Standard Rifle Section     
DPM Manouvre Support Section 	(5 men: 3 x SA80 2 x GPMG)	Manouvere Support Section

Royal Marines
==========================
DPM Troop Command Section	(3 men: 3 x SA80 1 x Clansman)	Troop HQ (with Medic)
DPM Royal Marines Rifle Sqd.	(8 men: 4 x SA80 1 x LSW 2 x SA80/UGL 1 x LMG 1 X LAW80)	Standard Rifle Section
Royal Marines Rifle Squad (GPMG)  	(10 men: 5 x SA80 1 x LSW 2 x SA80/UGL 1 x LMG 1 X LAW80 1 x GPMG)	
						Rifle Section with GPMG



7. COMMANDS AND FEATURES
=========================

7a. HeadGear and Visuals
=========================
These units have a number of additional features, most notable of these is the option to change some aspects of the visual appearence headdress on the units. this can be achieved in a number of ways. Firstly we have a selection of GameLogics under the Game Logic>UKF category. these work as follows:

'No Goggles': this removes the Goggles from all the units, the actions remain on the action menu at the moment.
'Bush Hat (1)' and '(2)': Adds Bushats (of 2 different styles) to all compatible UKF units.
'Daysack' and 'Patrolpack': Adds Backpacks (visual effect only) (of 2 different styles) to all compatible UKF units.
'No Radios': removes the PRR radios and headsets from all the units
'Override': turns off all the scripting, scripts will have to be started manually, or the units will appear with no headgear at all.

You can also override the scripts manually, its best to place an "Over Ride" gamelogic and set them manually. but it will work without one.
this adds a number of different looks to the soldiers. by placing:

<code>
[this, N] exec "\ukf_infantry\scripts\init_beret.sqs"
</code>

into the init of the DPM soldiers, where N is a number. The numbers on the following list represent the options:
(Don't forget to place the script overide game logic if using this script, for best results)

0 = No Beret
1 = Plain Dark Blue Beret
2 = Khaki Beret
3 = Scarlet Beret
4 = Rifle Green Beret
5 = Black Beret
6 = Maroon Beret
7 = Light Blue Beret
8 = Grey Beret

and the ones between 9 and 37 represent Different Regiments/corps

Guards Division
*************** 
9 = Grenadier Guards
10 = Coldstream Guards
11 = Scots Guards
12 = Irish Guards
13 = Welsh Guards

Queens Division
***************
14 = The Princess of Wales's Royal Regiment 
15 = The Royal Regiment of Fusiliers
16 = The Royal Anglian Regiment

Kings Division
**************
17 = The King's Own Border Regiment 
16 = The King's Regiment 
19 = The Prince of Wales's Own Regiment of Yorkshire
20 = The Green Howards
21 = The Queen's Lancashire Regiment 
22 = The Duke of Wellington's Regiment

The Prince of Wales's Division
******************************

23 = The Devonshire and Dorset Regiment
24 = The Cheshire Regiment
25 = The Royal Welch Fusiliers
26 = The Royal Regiment of Wales
27 = The Royal Gloucestershire, Berkshire and Wiltshire Regiment 
28 = The Worcestershire and Sherwood Foresters Regiment
29 = The Staffordshire Regiment

The Light Division
*******************

30 = The Light Infantry
31 = The Royal Green Jackets


32 = The Royal Irish Regiment

Combat Support
**************

33 = The Royal Engineers
34 = The Royal Signals
35 = The Royal Artillery 
36 = The Royal Electical And Mechanical Engineers 
37 = The Intelligence Corps

99 = Bush Hat 1
98 = Bush Hat 2



Parachute Regiment/ Airborne Forces
***********************************

<code>
[this, N] exec "\ukf_para\scripts\init_patch_para.sqs"; [this, N] exec "\ukf_para\scripts\init_Beret_para.sqs"
</code>

1 = 1st Battalion, The Parachute Regiment
2 = 2nd Battalion, The Parachute Regiment
3 = 3rd Battalion, The Parachute Regiment
4 = 4th (TA) Battalion, The Parachute Regiment
5 = 7th Parachute Regiment, Royal Horse Artillery 


You can also add daysacks and patrolpacks to individual soldiers by putting

<code>
[this] exec "\ukf_infantry\scripts\daysack.sqs"
<\code>

or

<code>
[this] exec "\ukf_infantry\scripts\Patrolpack.sqs"
<\code>

7b. Animiations
===============

Raise Goggles:
[code]
this animate ["goggles", 0]
[end code]

Lower Goggles:
[code]
this animate ["goggles", 1]
[end code]

To check if goggles are raised or lowered, you can use;

Goggles are down:
[code]
unitname animationPhase "goggles" == 0
[end code]

Goggles are Up:
[code]
unitname animationPhase "goggles" == 1
[end code]

Remove Helmet:
[code]
[""HelmetState"", 1]
[end code]

example: 
[this, N] exec "\ukf_infantry\scripts\init_beret.sqs"; {_X animate ["helmetstate", 1]} ForEach Units Group This
Where N equals the number of the selected beret/bush hat. (see 7a. HeadGear and Visuals)
Replace Helmet:
[code]
[""HelmetState"", 0]
[end code]

7c. Customizable Selections
****************************

Left Arm Patch
this setObjectTexture [0,"nameoftexture.paa"];

Right Arm Patch
this setObjectTexture [1,"nameoftexture.paa"];

Rank Slide
this setObjectTexture [2,"\ukf_infantry\rank\nameoftexture.paa"];

options are:

rank_lcpl.paa		Lance Corporal
rank_cpl.paa		Corporal
rank_sgt.paa		Sergeant
rank_CSM.paa		Company Sergeant Major
rank_CQSM.paa		Company Quatermaster Sergeant Major
rank_ssgt.paa		Staff Sergeant

rank_2lt.paa		Second Lieutenant
rank_lt.paa		Lieutenant
rank_cpt.paa		Captain
rank_maj.paa		Major
rank_ltcol.paa		Lieutenant Colonel
rank_col.paa		Colonel
rank_brig.paa		Brigadier

7d. Working Bayonets
****************************
All you do is hit the "Fix Bayonet" option in your action menu and get close to any hostile unit. You will then automatically stab and kill them.
To get your AI to fix bayonets, just hit the "Give Order: Fix Bayonets" option in your action menu and your AI with SA80s will attach their bayonets!

8. GLOSSARY
===========
DPM - 		Disruptive Pattern Material
UGL - 		Underslung Grenade Launcher (AG36)
LAW 80 - 	                    Light Anti-armour Weapon
SA80 - 		Small Arms 80 (of the eighties)
L85A2 -		Land service 85 Advance 2
LSW -		Light Support Weapon
SUSAT - 	                    Sight Unit Small Arms Trilux
PLCE - 		Personal Load Carrying Equipment
LMG - 		Light Machine Gun
GPMG - 		General Purpose Machine Gun

9. APPENDIX A
=============

The basic building bricks of the Infantry Battalion are the platoon and the section. Under normal circumstances, expect a British Infantry Platoon to 
contain the following:

Platoon HQ:
**********
Platoon Comander (Lt)
Platoon Sergeant (Sgt)
Radio Operator

3 x Rifle Sections
*******************
Fireteam 

Section Commander (Cpl)
Rifleman
Rifleman
LSW Gunner

Fireteam

Section 2 i/c (L/Cpl)
Rifleman
Rifleman
LSW Gunner

Manoevere Support Section
*************************
Section Commander (Cpl)
GPMG Gunner
Rifleman
GPMG Gunner
Rifleman

Following the recent conflicts in Iraq the army has begun to issue Light Machine Guns and Under Barrel Grenade Launchers in order to 
improve the firepower of the platoon.



10. FINAL WORD
====================

Please feel free to visit our website and forums at:
http://www.project-ukf.com

E-mail us with any comments and suggestions to:    contact@project-ukf.com

Report any bugs to:    bugreports@project-ukf.com

If you wish to edit or use anything from this or any future UKF releases, please contact us first to seek permission. If you do not gain
permission first, before using any of Project: UKF's material, it will be classed as theft and regarded as such.

***THIS IS NOT AN OFFICIAL ADDON, USE AT YOUR OWN RISK***
