M136 AT4 by Lowlands Warrior
Version: 2.0

REQUIRES ORIGINAL VERSION OF OPERATION FLASHPOINT:1985, GOTY AND/OR RESISTANCE, VERSION 1.1 OR NEWER.


LICENSE AGREEMENT:
------------------
THIS SOFTWARE IS NOT CREATED BY BOHEMIA INTERACTIVE STUDIO S.R.O. OR CODEMASTERS SOFTWARE COMPANY LTD. AND THEY DON’T HAVE ANY RESPONSIBILITY FOR THE SOFTWARE.

IMPORTANT - READ CAREFULLY: BY OPENING THIS PACKAGE, AND/OR INSTALLING OR OTHERWISE USING THE SOFTWARE, YOU AGREE TO BE LEGALLY BOUND BY THE TERMS AND CONDITIONS OF THE END-USER LICENSE AGREEMENT WITH LOWLANDS WARRIOR. IF YOU DO NOT AGREE TO THE TERMS OF THE AGREEMENT, YOU ARE NOT AUTHORIZED TO USE THE SOFTWARE. THIS SOFTWARE IS PROVIDED TO YOU AS FREEWARE.

A COPY OF THE END-USER LICENSE AGREEMENT CAN BE FOUND IN THE SAME ARCHIVE THAT THIS DOCUMENT CAME IN.


CREDITS
-------
Consultancy:	Pte. "Assault (CAN)" Stefanich, Pte. Frandsen (DK), "Crassus" (USA)

Model by:	Willem-Matthijs Crielaard
Skin by:	Willem-Matthijs Crielaard
Config by:	Willem-Matthijs Crielaard

If you want to contribute to this addon, send an e-mail to matthijs@myrealbox.com



UPDATES FOR VERSION 1.2 (26-12-2003)
-----------------------------------
- Fixed: "Time to live" error in weapon crates removed
- Fixed: no inventory image shown for AT4 warhead

UPDATES FOR VERSION 1.1 (26-12-2003)
-----------------------------------
- Enhanced model
- Improved skin
- Modelspecial feature (packed/unpacked weapon models visible in-game)
- New sounds
- Weapons distributed with cases instead of units (prevents cluttering of editor menu)


OBJECTS AVAILABLE IN THIS ADDON:
--------------------------------
kmmm136at4	M136 AT4, light anti-tank weapon 
kmmm136mag	M136 AT4 warhead
kmmm136case	crate containing 5x M136 AT4 (Requires Operation Flashpoint: Resistance)



INFORMATION:
------------
The AT4 is a preloaded, one shot disposable anti-armour weapon. The weapon fires an 84 mm HEAT (high explosive anti-tank) projectile, and has an effective range of 300 meters. The warhead is known for its effective ability of penetrating light-armed vehicles. The AT4 CS is a version of the AT4 and is developed for use in urban areas.

The AT4 is in use by various military forces worldwide. 800 000 copies have been made of these weapons, 300 000 of them made under license by the USA based company Alliant Techsystems Inc.

Production: In production by Bofors AB. Formerly made under license in USA by Alliant Techsystems Inc.
Service: Sweden, USA, Denmark, Netherlands, Brazil and Venezuela
Calibre: 84 mm
Length: 1.04 m
Weight: 7.5 kg
Effective range: 300 meters
Muzzle velocity: 220 m/s
Armour penetration: >500 mm

Source: Jane's publications (Infantry Weapons, 1999-2000)
NISAT (30.08.2000)



INSTALLATION & USE:
-------------------
Use the following procedure:

Extract kmmm136at4.pbo from the archive, and put in operation flashpoint\addons
Extract kmmm136case.pbo from the archive, and put in operation flashpoint\res\addons

After installation, you can find military weapon crates containing weapons the weapons in the editor, under the side “Empty”, as “KMM – Man packed weapons”.

You can also add weapons and ammo to units and cargo, by using addweapon/addmagazine scripting commands. Use the classnames in classnames.htm for reference. For more information on scripting, see the official scripting reference on http://www.flashpoint1985.com/breathe/



INFORMATION FOR MISSION MAKERS
------------------------------
When creating a mission using weapons from the Lowlands Warrior M136 AT4, you have 4 options:
•	Placing the weapon crates on the map (Resistance only)
•	Using addweapon to place the AT4 on units
•	Using addweaponcargo to place the AT4 in vehicles
•	Using description.ext to allow selection from the briefing screen


PLACING CRATES(only for Operation Flashpoint: Resistance)

In the editor menu, press F1 and double-click on the map. You will see a dialog in which you can choose a side, object type and object.
•	First, make sure you have a player unit on the map. For example, a soldier.
•	Next, from Side: “Empty” select a category. The AT4 category is:
	KMM – Man packed weapons

Click on Preview, walk up to the weapons crate and take an AT4.


USING ADDWEAPON

In the editor menu, press F1 and double-click on the map. You will see a dialog in which you can choose a side, object type and object. Double click the map, and place a unit on the map (make sure it’s not a vehicle or object).

In the INIT field of the unit, type the following commands on a single line:

------
RemoveAllWeapons this; this AddMagazine "<magazineclass>"; this AddWeapon <weaponclass>";
------
 
Substitute <magazineclass> for the magazine type you want, and substitute <weaponclass> for the weapon class you want.

For example, to give a unit the AT4 with and a charge, use the following commands on one line:

------
RemoveAllWeapons this; this AddMagazine "kmmm136mag"; this AddWeapon " kmmm136at4";
------

Adding the warhead before adding the weapon has a reason: doing this will put the weapon in inventory loaded, ready to fire. If you add the weapon first, the unit will have to reload first, before it can fire it’s weapon.



USING ADDWEAPONCARGO 

In the editor menu, press F1 and double-click on the map. You will see a dialog in which you can choose a side, object type and object. Double click the map, and place a vehicle on the map (make sure it’s a vehicle that has some cargo space).

In the INIT field of the vehicle, type the following commands on a single line:

------
clearMagazineCargo this; clearWeaponCargo this; this addWeaponCargo ["<weaponclass>",<number>]; this addMagazineCargo ["<magazineclass>", <number>]
------


Substitute <magazineclass> for the magazine type you want, and substitute <weaponclass> for the weapon class you want. Substitute <number> for any number of weapons and/or magazines you want to add.

------
clearMagazineCargo this; clearWeaponCargo this; this addWeaponCargo ["kmmm136at4",10]; this addMagazineCargo ["kmmm136mag", 10]
------

First, all magazines and weapons are removed from the vehicles cargo. Next, the addWeaponCargo command adds 10 AT4’s. Finally, the addMagazineCargo adds the magazines/warheads.



USING DESCRIPTION.EXT

This section offers only a basic explanation on how to add weapons to a briefing screen. For more information on how to use the description.ext file, refer to the Operation Flashpoint Editing Center (http://www.ofpec.com/)

In the mission editor, create a mission and save it. Now, using the Windows Explorer, go to you missions folder and open the mission you just created. Create a new file called “description.ext”, or open the description.ext file if it already exists.

In this file, add the following section:



class Weapons {
	class <weaponclass> { count = <number> };	
};

class Magazines{
	class <magazineclass> { count = <number> };	
};



Substitute <magazineclass> for the magazine type you want to add, and substitute <weaponclass> for the weapon class you want add. Substitute <number> for any number of weapons and/or magazines you want to add.

The lines “class <weaponclass> { count = <number> };” can be repeated, to add several magazine and/or weapon types to the briefing screen. For example, if we are creating a mission in which the player can choose from the following:


Weapons
2 pcs. M136 AT4


Magazines:
2 pcs. M136 AT4 warheads


The section in the description.ext would look like this:

 
class Weapons {
	class kmmm136at4 { count = 2 };		
};

class Magazines{
	class kmmm136mag { count = 2 };
};





