FN HERSTAL MAG 58 by W.M. Crielaard, http://mods.kmarns.net/
Version: 2.1



IMPORTANT
---------
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
-------
Model by Willem-Matthijs Crielaard
Original optics by OFP Taiwan workshop
Coding by Willem-Matthijs Crielaard
Skinning/Importing to OFP by Willem-Matthijs Crielaard
Military consultancy by "Assault[CAN]" Tyler



UPDATES FOR VERSION 2.0 (28-06-2004)
-----------------------------------
- Changed: classnames have been changed drastically. This add-on is not backwards compatible with any older versions.
- Improved: skin tones
- Improved: ammo belt model
- Improved: belt feeding visuals



NEW OBJECTS AVAILABLE
----------------------
IN FILE “KMMFNMAG.PBO”:
KMMGPMG			General Purpose Machinegun, a generic designation
KMMFNMAG		Dutch, Belgian, and French designation “FN MAG 58”
KMML7A2			British designation “L7A2 GPMG”
KMMKSPM58		Swedish designation “KSP M/58”
KMMC6			Canadian designation “C6 GPMG”
KMMGPMGMAG		100-round BALL ammo box for GPMG’s
KMMGPMGTRCMAG		100-round TRACER ammo box for GPMG’s
KMMGPMGMAG_AI		100-round BALL ammo box, special for AI gunners
KMMGPMGTRCMAG_AI	100-round TRACER ammo box, special for AI gunners

IN FILE “KMMJAMFNMAG.PBO” (RESISTANCE ONLY!):
KMMJAMGPMG		JAM compliant General Purpose Machinegun
KMMJAMFNMAG		JAM compliant Dutch, Belgian, and French designation
KMMJAML7A2		JAM compliant British designation “L7A2 GPMG”
KMMJAMKSPM58		JAM compliant Swedish designation “KSP M/58”
KMMJAMC6		JAM compliant Canadian designation “C6 GPMG”

IN FILE: “KMMFNMAG_MEN.PBO” (RESISTANCE ONLY!):
KMMSOLDIERGPMG		Machinegunner, armed with GPMG
KMMSOLDIERFNMAG		Machinegunner, armed with FN MAG 58
KMMSOLDIERL7A2		Machinegunner, armed with L7A2 GPMG
KMMSOLDIERKSP		Machinegunner, armed with KSP M/58
KMMSOLDIERC6		Machinegunner, armed with Diemaco C6 GPMG
KMMSOLDIERGPMGAI	Machinegunner, armed with GPMG, and special ammo for AI
KMMSOLDIERFNMAGAI	Machinegunner, armed with MAG, and special ammo for AI
KMMSOLDIERL7A2AI	Machinegunner, armed with L7A2, and special ammo for AI
KMMSOLDIERKSPAI		Machinegunner, armed with KSP M/58, and special ammo for AI
KMMSOLDIERC6AI		Machinegunner, armed with C6 GPMG, and special ammo for AI



INFORMATION
------------
7.62mm NATO caliber support weapon
Rate of fire: ~ 700-800 (adjustable through 3-positions)
Modes of fire: full-automatic
Magazine capacity: belt fed (in this add-on 100 rounds ammo box)

This add-on was made to be as realistic as possible, but it is still balanced to be used along with the original Operation Flashpoint weapons.

The following details received special attention, to make your FN MAG experience as realistic as possible:
- Realistic ammo box: based on the box in use with British armed forces.
- Realistic shell casing ejection: from the bottom of the gun
- Realistic rate of fire
- Real FN MAG sound
- Photorealistic skin
- Highly detailed model
- "Optics" represent the real FN MAG iron sight

The FN HERSTAL MAG has continuously proven itself in combat operations and is widely recognized as the world's most reliable and versatile general purpose machinegun. It has been adopted by over 70 countries under various designations: MAG 58, GPMG, L7A2, M/58 and C6.



INSTRUCTIONS
-------------
Operation Flashpoint:Resistance - extract the .PBO files, and put them in your <Operation Flashpoint>\RES\addons folder.

Operation Flashpoint:Resistance - extract the KMMFNMAG.PBO, and put it in your <Operation Flashpoint>\addons folder.



NOTE TO MISSION MAKERS
----------------------
If you are making a mission for Operation Flashpoint: Cold War Crisis, you cannot use the add-ons in KMMFNMAG_MEN.PBO and KMMJAMFNMAG.PBO. To equip soldiers with the required weapons, you will have to manually add them by using the addweapon and addmagazine commands, or defining them in your briefing.ext.

Be aware that if your make a mission that uses a custom addon, the addon will need to be distributed with your mission.



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.

Adding the magazine 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 its 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.




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. L7A2 GPMG


Magazines:
2 pcs. 100-round BALL ammo box


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

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

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


