ME2 Weaponry tweaks

- General description;
- Edit description;
- Weaponry Loadouts;
- Weaponry general description;
- Weapon template;
- Global properties;
- Specialized properties;
- Additional properties;


[++++++++++++++++++++ General description ++++++++++++++++++++]

All game settings are stored in Coalesced.ini file:
	Mass Effect 2\BioGame\Config\PC\Cooked\

Programs required:
Notepad++ and ME2IniFixer
https://notepad-plus-plus.org/download/v6.9.1.html
https://www.nexusmods.com/masseffect2/mods/116/?

Edit DLC Bio.ini files: doesn't required to use ME2IniFixer;


Main game weapons properties are stored in Coalesced.ini; 
DLC weapons properties are stored in BIOWeapon.ini (in each DLC folder);

All information about mod's weapon stats (properties) described in tables (.xls files):
	Infinite ammo system - ME2 WT IA;
	Heat/thermal clips system - ME2 WT HT;


[++++++++++++++++++++ Edit description ++++++++++++++++++++]

Download Notepad++; DO NOT USE Word, Wordpad or Notepad - this will break game files;
- go to: Mass Effect 2\BioGame\Config\PC\Cooked\ and open Coalesced.ini file;
- right-click on file > Edit with Notepad++

	// How to compare two files in Notepad++ ? //
In Notepad++ add plugin "Compare":
main panel > plugins > plugin manager > show plugin manager > find plugin Compare > Install >
> (if program asks if you would like to update manager? - Yes, only once) >
> Open two Coalesced.ini-s > main panel > plugins > Compare > select one of two files > Set as first to compare > 
> switch to second file > main panel > plugins > Compare > Compare
Differences between two files will be highlighted;

Commenting code: comment prevent game engine from reading and executing commands in string.
[< ; >] semicolon before string:  ;Variable=Value

	If you want to use several Coalesced.ini mods, create merged file:
- copy your current moded file from: Mass Effect 2\BioGame\Config\PC\Cooked\ to any folder (as backup);
- download mod > compare mod file and your file in Notepad++: use Compare plugin > find differences > copy code from mod file to your file (ignore iniversion strings);
- Launch ME2IniFixer;
> if mod is require specific code to run properly - that code takes priority over the others mods code;
> if mod adds new stuff > use mod values instead of yours;
> if some setting has greater/lesser value in compare to your file > read mod description about this value > choose one variant (not both);

    EDIT FILE > LAUNCH ME2IniFixer > LAUNCH GAME

	^ Definitions:
String/line - Variable=Value
AI - Artificial Intelligence - game engine code that supervise squadmates and enemies behavior;
	there are several setting that assigned separately for squad and enemies:

AI = Enemies and Squadmates - by default, if not specified;  (all non-player values);
Squad = Squadmember = Squadmate = Hench = Henchman;  (separate values);
	- squad is squadmember only, not including Shep;

RateOfFire = Firerate;
Crosshair = Scope = Sight;
Magazine = Clip;
Shots = Bullets = Rounds = Projectiles;

	^ Description structure:
[SFXGame.SFXWeapon] - section in file;
Damage= - variable;
1.0 - value;
~=  - approximately equal (exact value property is unknown);

	^ Numerical values:
Integer: Y=80; (min=0; max=unlimited, (recomended=999));
Boolean: true / false; (true=yes/on/use; false=no/off/don't use);
Float type1: 0.7; (min=0.0/0; max=unlimited, (recomended=99.0));
Float type2: 0.7f; (min=0.0f; max=unlimited, (recomended=99.0f)); (f=float);
> if value = 0/0.0/0.0f than it will be disabled (unused);

	^ Examples:
RateOfFire=(X=850,Y=850); (where always X=Y);
CrosshairRange=(X=35,Y=80); (where X= min value; Y= max value (from X to Y));
bInfiniteAmmo=true; (true=yes/false=no); (b=boolean);
BurstRefireTime=0.1 (result will be in %-s 0.7f=70%, where 1.0f=100%(max));
DamageAI=0.7f; (result will be in %-s 0.7f=70%, 1.3f=130%; where 1.0f=100%);

	^ Formulas:
Damage=(X=100.0,Y=100.0) // of gun, used by player //
1.0f = 100%
DamageAI=0.7f = 70%
100 * 0,7 = 70
DamageAI=(X=70.0,Y=70.0) // of gun, used by AI //

> AR - Assault Rifles;  SG - ShotGuns;  SR - Sniper Rifles;  HP - Heavy Pistols;  AP - Auto Pistols;  HW - Heavy Weapons;



[++++++++++++++++++++ Weaponry Loadouts ++++++++++++++++++++]

	[SFXGame.SFXPlayerSquadLoadoutData]
- Shepard and squad weapons classes usage settings - weapon types they can use in missions;

	Types of weapons/weapon classes:
LoadoutWeapons_ ...
	AssaultRifles, AutoPistols, HeavyPistols, Shotguns, SniperRifles, HeavyWeapons;

	Shepard's classes:
PlayerLoadoutInfo=(ClassName=SFXPawn_PlayerSoldier,WeaponClasses=(LoadoutWeapons_ ...))
	Squad:
HenchLoadoutInfo=(ClassName=SFXPawn_Garrus,WeaponClasses=(LoadoutWeapons_ ...))

DLC squadmates: Kasumi, Zaeed and Liara:
	Kasumi: Mass Effect 2\BioGame\DLC\DLC_HEN_MT\CookedPC\BIOGame.ini
	Zaeed: Mass Effect 2\BioGame\DLC\DLC_HEN_VT\CookedPC\BIOGame.ini
	Liara: Mass Effect 2\BioGame\DLC\DLC_EXP_Part01\CookedPC\BIOGame.ini
ME2IniFixer don't needed when you edit dlc files;

> Shepard is able to use: maximum 5, minimum 2 weapon types;
> Squadmate is able to use: only 2 weapon types - min/max;
	- if you set more than max number, last weapon type will be invisible in weapon locker/weapon selection screen - choose wisely);
	- you can give HeavyWeapons to your squadmates - lot of fun guaranteed!



[++++++++++++++++++++ Weaponry general description ++++++++++++++++++++]

	======== Weapons structure hierarchy ========

XWeapon.pcc files stored weapon: construction materials/forms, projectile patterns and count, handling animation (firing, reloading, etc) - in short words, visuals;
> those files can be edited only by special programs (developers tools), none of them are available for users, for now on;

Coalesced.ini controls the gun direct behavior - i.e. how to shoot, how fast, what damage amount deal to the enemy, etc - in short words, mechanics;
DLC BIOWeapon.ini work as extension, by adding (loading) specific weapon to the resulted Coalesced file stucture
(not directly, DLC weapons are inherit only several global values from it);


	======== Types of properties ========

Weapon behavior determines by two types of properties - global and specialized:
> properties = damage, firerate, accuracy, etc;

	-------------------------- Global --------------------------
Effect on all weapons, stored in many different sections throughout Coalesced.ini;
- Shepard's, squadmate's, enemy weapons;

	[SFXGame.SFXWeapon] - base weapon model - all guns inherit their properties from it:
- Logic - if for specific weapon some variable (setting) not set (missing), than it will be inherited from SFXWeapon -
	specific weapon will use setting, that is set in SFXWeapon;
> for example, auto aiming parameters - only sniper rifles use them, and they have own valuse per each SR;
	other weapon classes will use values, that is set in SFXWeapon;
- DO NOT change values in [SFXGame.SFXWeapon], that present in specific weapon section - just copy them for gun, in which you want to use them;
> for example, don't change SFXWeapon > damage, firerate, accuracy, etc, because those values are used for enemy weapons stats calculation;

- You can override SFXWeapon values by adding them to specific weapon model (section):
> for example, you want to increase damage you deal at very long range (Range_Long=2000.f) by M-98 Widow:
	// copy line //
DamageMod_VeryLongRange=1.0f
	// from //
[SFXGame.SFXWeapon]
	// add line to //
[SFXGameContent_Inventory.SFXWeapon_MassCannon]
	// set value //
DamageMod_VeryLongRange=1.5f
- in result, Widow will deal +50% damage at very long range;
> Any string from [SFXGame.SFXWeapon] can be added to any weapon model;

Other weapon-related settings (outside out [SFXGame.SFXWeapon]), cannot be set for specific weapon:
> for example, bAimAssistEnabled=true cannot be added from [SFXGame.SFXGameConfig], as it will be applied for all weapons at once;


	-------------------------- Specialized --------------------------
Specific properties for each weapon are initialized/described in its section in Coalesced and BIOWeapon:
	[SFXGameContent_Inventory.SFXWeapon ... ]
> You can change/add any setting, that described in "Weapon template" below;
> Specific weapon sections names - full information in weapons tables;

! Important note: for SHOTGUNS, projectiles (pellets) count and spread are capped to: х8 for all shotguns, for "Geth plasma shotgun": x3;
	----------------------------------------------------
In result, each time when you launch the game, all properties for all weapons will be recalculated and set based on current string values;



[++++++++++++++++++++ Weapon template ++++++++++++++++++++]

- Strings, defining the mechanics of weapons;
// Settings description schema - each value is set to "0" as an example for each string - set your when edit //;

================= Global ==================

	======== Heat system =========
WeaponsUseHeat=true
HeatDissipationRate=0.0f
	======== Global damage =========
PlayerCoverDamageMultiplier=0.0f
PlayerCoverLeanDamageMultiplier=0.0f
PlayerStormDamageMultiplier=0.0f
	======== Global Ammo =========
bCanDropAmmo=true
PctChanceToDrop=0.0
PctAmmoGiven=0.0
	======== Shep's Accuracy =========
Base_Acc_Standing=0.0
Base_Acc_Zoom=0.0
AccMod_Move=0.0
AccMod_ViewTurn=0.0
AccMod_Crouched=0.0
AccMod_MouseMultiplier=0.0
AccMod_MaxCameraLoss=0.0
Base_Interp_Speed=0.0f
InterpMod_Move=0.0f
InterpMul_ViewTurn=0.0f
	======== Squad Accuracy =========
m_fStartThreshold_pistol=0.0
m_fStopThreshold_pistol=0.0
m_fDriftRadius_pistol=0.0
m_fStartThreshold_Shotgun=0.0
m_fStopThreshold_Shotgun=0.0
m_fDriftRadius_Shotgun=0.0
m_fStartThreshold_Assult=0.0
m_fStopThreshold_Assult=0.0
m_fDriftRadius_Assult=0.0
m_fStartThreshold_Sniper=0.0
m_fStopThreshold_Sniper=0.0
m_fDriftRadius_Sniper=0.0
m_fCrosshairAccuracyModifier=0.0
	======== Global Aiming assistance/Auto aiming =========
bAimAssistEnabled=true
GlobalFrictionFactor=0.0f;
GlobalAimCorrectionFactor=0.0f;
GlobalAdhesionFactor=(X=0.0,Y=0.0);
EnemyMovementAdhesionFactor=0.0;


================= Specialized ==================

	======== Damage =========
Damage=(X=0.0,Y=0.0)
DamageAI=0.0f
DamageHench=0.0f
	======== Firerate =========
RateOfFire=(X=0,Y=0)
RateOfFireAI=0.0f
	======== Fire types =========
bIsAutomatic=true
BurstRounds=0
BurstRefireTime=0.0
	======== Ammo ========
bInfiniteAmmo=true
MagSize=(X=0,Y=0)
InitialMagazines=0
MaxSpareAmmo=(X=0,Y=0)
AmmoPerShot=0
fAmmoMultiplier=0
LowAmmoSoundThreshold=0
NoAmmoFireSoundDelay=0.0
SteamSoundThreshold=0
LastBulletStrongerPercent=0.0f
	======== Accuracy ========
MinAimError=(X=0.0,Y=0.0)
MinZoomAimError=(X=0.0,Y=0.0)
MaxAimError=(X=0.0,Y=0.0)
MaxZoomAimError=(X=0.0,Y=0.0)
AccFirePenalty=0.0f
ZoomAccFirePenalty=0.0f
AccFireInterpSpeed=0.0f
ZoomAccFireInterpSpeed=0.0f
	======== Sight ========
CrosshairRange=(X=0.0,Y=0.0)
ZoomCrosshairRange=(X=0.0,Y=0.0)
bUseSniperCam=true
ZoomFOV=0
	======== Recoil =========
Recoil=(X=0.0,Y=0.0)
ZoomRecoil=(X=0.0,Y=0.0)
RecoilCap=0.0f
ZoomRecoilCap=0.0f
RecoilInterpSpeed=0.0f
RecoilFadeSpeed=0.0f
RecoilZoomFadeSpeed=0.0f
RecoilYawScale=0.0f
RecoilYawBias=0.0f
RecoilYawFrequency=0.0f
RecoilPitchFrequncy=0.0f
RecoilMinFadePitch=0.0f
RecoilMinFadeYaw=0.0f
RecoilPitchOscillation=0.0f
	======== Reload speed ========
ReloadSuccessDuration=0.0
ReloadFailureDuration=0.0
EjectShellCasingTimeRatio=0.0
	======== Tracer projectiles ========
TracerSpawnOffset=0.0
TraceRange=0
ShowTracerDistance=0
	======== Fire range & ranged damage ========
Range_Melee=0.0f
Range_Short=0.0f
Range_Medium=0.0f
Range_Long=0.0f
DamageMod_MeleeRange=0.0f
DamageMod_ShortRange=0.0f
DamageMod_MediumRange=0.0f
DamageMod_LongRange=0.0f
DamageMod_VeryLongRange=0.0f
ImpactRelevanceDistance=0
	======== Aiming assistance/Auto aiming ========
MagneticCorrectionThresholdAngle=0
MaxMagneticCorrectionAngle=0



[++++++++++++++++++++ Global properties ++++++++++++++++++++]

	======== Weapon heat model ========

WeaponsUseHeat=true
	- All non-Heavy weapons can use heat system - ammo in magazine will start to restore after certain time (HeatDissipationRate),
	just like in ME1 - in result, you'll get semi heat/thermal clip system:

	> while you fire from gun, ammo will decrease, if you spend entire magazine, gun will be reloaded
	and ammo for current magazine will be resupplied from spare ammo stock;
	> if you'll stop firing, ammo will start to regenerate (no ammo will be spend from spare ammo stock);
	> weapon cannot be reloaded during ammo regeneration - it will be auto reloaded after entire magazine will be drained;
	! - if this value set to true, it will override bInfiniteAmmo parameter for all weapons;
	> thermal clips and heavy weapon ammo boxes would work as usual - spare ammo stock will be resuplied when you'll pick them;

> I think this is how developers supposed to implement their "thermal clips idea" - give players a choice: restore ammo in magazine or spend spare ammo!

HeatDissipationRate=0.0f
	- Percent of ammo for current magazine (MagSize) that would be restored in heat mode;
	min=0.01f; max=1.0f;  // in %-s //;


	======== Global damage =========
PlayerCoverDamageMultiplier=0.0f
PlayerCoverLeanDamageMultiplier=0.0f
PlayerStormDamageMultiplier=0.0f
	- Damage multipliers when Shep shoots from cover and while sprinting;
	min=0.01f; max=unlimited;  // in %-s, as (Damage=) multiplier //;  (1.0f=100%)
	- All values =1.0f - the weapon will deal same (static) amount of damage, no matter the the situation;

	======== Global ammo ========

bCanDropAmmo=true
	- Enemy can drop ammo when Shep kills them;
	true=yes; false=no;

PctChanceToDrop=0.0
	- Enemy ammo drop chance;
	min=0.0; max=1.0;  // in %-s //;  (1.0=100%);
	0.0 = enemy ammo drop disabled;

PctAmmoGiven=0.0
	- Ammo amount given (granted) when Shep picks thermal clip, including heavy weapons ammo boxes;
	min=0.0; max=1.0;  // in %-s //;  (1.0=100%);
	0.0 = ammo won't be resupplied;


	======== Shep's accuracy ========

Base_Acc_Standing=0.0
Base_Acc_Zoom=0.0
	- Base accuracy loss when Shep stand and aim;
	min=0.0; max=unlimited;  // in %-s //;  (1.0=100%);
	0.0 = no accuracy losses;

AccMod_Move=0.0
AccMod_ViewTurn=0.0
AccMod_Crouched=0.0
	- Accuracy loss when you: move, turn, in cover;
	min=0.0; max=unlimited;  // in %-s //;  (1.0=100%);
	0.0 = no accuracy losses;

AccMod_MouseMultiplier=0.0
AccMod_MaxCameraLoss=0.0
	- Accuracy loss when you turn mouse;
	min=0.0; max=unlimited;  // in %-s //;  (1.0=100%);
	0.0 = no accuracy losses;

Base_Interp_Speed=0.0f
InterpMod_Move=0.0f
InterpMul_ViewTurn=0.0f
	- Base accuracy modifiers for how quickly accuracy parameters approximate their maximal values per shot when Shep: stand, move, turn;
	min=0.01; max=100.0;

m_fCrosshairAccuracyModifier=-17.0
	- Determines weapon scope size increase/per shot (CrosshairRange=(X=0.0,Y=0.0) + this value/per shot // X=min; Y=max //);


	======== Squad accuracy ========

m_fStartThreshold_pistol=0.0
m_fStopThreshold_pistol=0.0
m_fDriftRadius_pistol=0.0
m_fStartThreshold_Shotgun=0.0
m_fStopThreshold_Shotgun=0.0
m_fDriftRadius_Shotgun=0.0
m_fStartThreshold_Assult=0.0
m_fStopThreshold_Assult=0.0
m_fDriftRadius_Assult=0.0
m_fStartThreshold_Sniper=0.0
m_fStopThreshold_Sniper=0.0
m_fDriftRadius_Sniper=0.0
	- Base values for bullet spread/aim error (cone of bullets calculation per shot) for squadmates;
	min=0.001; max=99.0;  // in %-s //; // as +% from base values of specific weapon //;
	// all "0" values = accuracy=100% //;
	- nearly impossible to test, set any values;


	======== Global Aiming assistance/Auto aiming ========

> This option generaly used in consoles - it helps player to aim more accurate via auto-aiming;

bAimAssistEnabled=true
	- Auto aiming, works like homing-sticky projectiles;
	true = on; false = off;

GlobalAimCorrectionFactor=0.0f;
AimCorrectionAmount=0.0
	- Ballistics: converts all projectiles to homing-sticky type (how close from enemy you need to shoot, that projectile can stick to enemy);

GlobalFrictionFactor=0.0f;
	- Ballistics: wiki: the force resisting the relative motion of solid surfaces, fluid layers, and material elements sliding against each other;
	when you shot mised the target (when you shot nearly reach target, but missed for 1-2 cm), the projectile converts to homing-sticky type,
	and still can reach target (but for very close distance from it) - defined by multiple friction values for specific weapon;
	by default, used by SR and SG to help player hit targets when they missed;

GlobalAdhesionFactor=(X=0.0,Y=0.0);
EnemyMovementAdhesionFactor=0.0;
	- Ballistics: wiki: tendency of dissimilar particles or surfaces to cling to one another
	(cohesion refers to the tendency of similar or identical particles/surfaces to cling to one another). 
	- mathematical graph of bullet spread (cone of bullets calculation when you shoot);



[++++++++++++++++++++ Specialized properties ++++++++++++++++++++]

> Described strings from [SFXGame.SFXWeapon], that can be set for specific weapon;

	======== Damage =========

> Keep in mind, that weapon damage is increase by bonus values: Shep's and squadmate's class skills, armor and gear, research upgrades;

Damage=(X=0.0,Y=0.0)
	- Base damage of the gun without bonuses, each bonus will increase this value on certain %t:
	Damage=(X=100.0,Y=100.0)
	+ 10% = 0.10
	Damage=(X=110.0,Y=110.0)

DamageAI=0.0f
	- Damage multiplier for enemies, in relation to Damage=(X=0.0,Y=0.0) value;
	Damage=(X=100.0,Y=100.0) = Damage=1.0f (=100%);
	DamageAI=1.3f = Damage=(X=130.0,Y=130.0) (=130%);

DamageHench=0.0f
	- Damage multiplier for squad, in relation to Damage=(X=0.0,Y=0.0) value;
	Damage=(X=100.0,Y=100.0) = Damage=1.0f (= 100%);
	DamageHench=1.0f = Damage = equals Shep's damage;


	======== Firerate =========

RateOfFire=(X=0,Y=0)
	- projectiles count released by weapon when fire trigger is pressed - how fast weapon can fire;
	- for weapon, used by Shep;
	min=10; max=9999;  // X always equals Y //;
	100 = 1 shot/second;

RateOfFireAI=0.0f
	- Rate of fire for enemy and henchmen weapon, in relation to RateOfFire=(X=0,Y=0) value;
	min=0.01f; max=unlimited;  // in %-s //;  (1.0f=100%);

	RateOfFire=(X=100.0,Y=100.0) = RateOfFire=1.0f (=100%);
	RateOfFireAI=0.9f = RateOfFireAI=(X=90.0,Y=90.0) (=90%);


	======== Fire types =========

> All fire types consider RateOfFire parameter;

	// full auto //
bIsAutomatic=true
	- Weapon doesn't require to rearrange the trigger to keep firing;
	true=on; false=off;
	- Sets full-auto firetype;
	- Disables/overrides burst-fire type;

	// semi-auto/single/burst //
BurstRounds=0
	- Number of projectiles per burst;
	min=0; max=MagSize;
	- if max value is used, entire magazine will be relinquished with one button press;
	- set =0 or =1 for burst fire type weapon to convert it to full auto;

	MagSize=(X=30,Y=30)
	BurstRounds=3
	(MagSize)/(BurstRounds) = (MagSize=10);
	- you'll be able to shoot 10 times with 3 bullets per shot;

BurstRefireTime=0.0
	- Delay before next burst;
	min=0.0; max=1.0;  // in seconds //;  (1.0=1 second);
	- Sets semi-auto/single/burst-fire firetypes (depends of RateOfFire);
	- Disables/overrides full-auto firetype;

	// charge //
- weapon charged projectile mechanic is stored in XWeapon.pcc files - for now, they can't be edited;
Charge fyre type cannot be effectively overridden by .ini file values:
- can be converted to semi-auto;
- cannon be converted to full-auto;
	But if you realy-realy want to set it anyway, in that case, bIsAutomatic=true will work this way:
when you press fire button, weapon will continue firing untill entire magazine/ammunition stock (for heavy weapon) will be empty;
firing can be stopped (canceled) by pressing fire button again;
> for example: set bIsAutomatic=true for M-622 Avalanche - [SFXGameContent_Inventory.SFXHeavyWeapon_FreezeGun]
	and admire the unstoppable blizzard ;)


	------------- Fire types construction -------------

> not included - string could be not present in weapon section;

	// Full-auto // simple;
bIsAutomatic=true
RateOfFire= more than 100;
	-------------
	// Semi-auto // simple;
bIsAutomatic=false  (or not included);
RateOfFire= less than 100;
	-------------
	// Single // simple;
bIsAutomatic=false;
RateOfFire= less than 90;
	-------------
	// Full-auto // with more delay between shots;
bIsAutomatic=true
RateOfFire= more than 100;
BurstRounds=1
BurstRefireTime= from 0.6 to 0.9
	-------------
	// Semi-auto // with more delay between shots;
bIsAutomatic=false  (or not included);
RateOfFire= any, more than 500;
BurstRounds=1
BurstRefireTime= from 0.1 to 0.9
	-------------
	// Single // with more delay between shots
bIsAutomatic any true/false  (or not included);
RateOfFire= less than 80;
BurstRounds=1
BurstRefireTime= from 0.9 to 1.0
	-------------
	// Burst //
bIsAutomatic=false
RateOfFire= any, more than 200;
BurstRounds= min=2; max=MagSize;
BurstRefireTime= from 0.1 to 0.5
	-------------
	// Full-auto Burst //
(example: M-15 Vindicator custom model);
bIsAutomatic=false
RateOfFire=(X=600,Y=600)
BurstRounds=3
BurstRefireTime=0.3f
MinRefireTime=0.3f

	------------- AI weapons -------------
	// X=min; Y=max //;

AI_BurstFireCount=(X=0,Y=0)
	- Amount of bursts (shots) enemies and henchmen will shoot (during several seconds ~=7 seconds);
	min=1; max=MagSize;
AI_BurstFireDelay=(X=0.0f,Y=0.0f)
	- Time enemies and henchmen wait between firing bursts (AI_BurstFireCount) from cover;
	min=0.01f; max=unlimited;
AI_BurstFireMovingDelay=(X=0.0f,Y=0.0f)
	- Time enemies and henchmen wait between firing bursts (AI_BurstFireCount) out of cover;
	min=0.01f; max=unlimited;


	======== Ammo ========

> Keep in mind, that ammo capacity is increase by bonus values: armor and gear, research upgrades;

bInfiniteAmmo=true
	- All weapons can use infinite ammo system - ammo in magazine will be decreased on firing,
	and after weapon reloading, the spare ammo stock won't be decreased;
	- You can reload weapon anytime;  Thermal clips now irrelevant - you'll never run out of ammo;
	true=on; false=off;

MagSize=(X=0,Y=0)
	- Number of rounds (projectiles) in gun's current magazine;
	min=1; max=9999;  // X always equals Y //;

InitialMagazines=0
	- Number of spare magazines;
	min=1; max~=99;

MaxSpareAmmo=(X=0,Y=0)
	- Number of total spare ammo;  stock
	MaxSpareAmmo= (MagSize)*(InitialMagazines);  // X always equals Y //;
// For single-shot weapons types, such as Widow, set custom number - for example, 40 //;

AmmoPerShot=0
	- Amount of ammo spent per shot;
	min=0; max=MagSize;
// min=0; = infinite ammo without reloading (ammo in current magazine won't be decreased at all) //;
// warning!: if you set this value to M-3 Predator - you won't be able to pass tutorial level (Lazarus station),
	as weapon needs to be reloaded there to open the door //;

fAmmoMultiplier=0.5
	- Ammo consumption coefficient;
	min=0.1; max=1.0;  // in %-s //;
// used in Nuke launcher (Cain) - its ammunition counts as %-t of charge //;

LowAmmoSoundThreshold=0
	- Low ammo warning - starts, when (this value) rounds in current magazine left;
	min=0; max=MagSize-1;

NoAmmoFireSoundDelay=0.0
	- Delay before pulling the trigger and playing "click" sound for weapon without ammo;
	min=0.0; max=99.0; // in seconds //;

SteamSoundThreshold=0
	- Amount of ammo to be left in clip before playing "running low" sound along with normal shooting sound;
	min=0.0; max=99.0; // in seconds //;

LastBulletStrongerPercent=0.0f
	- Last bullet from magazine will deal more damage;
	min=0.0f; max=99.0f;  // in %-s //;  (1.0f=100%)


	======== Accuracy ========

> Counts as increasing value: lesser values = more accuracy;
	0.1 ~= 1 cm;
// all "0" values = accuracy=100% //;

MinAimError=(X=0.0,Y=0.0)
MaxAimError=(X=0.0,Y=0.0)
	- Bullet drift per shoot from the hip (without aiming);

MinZoomAimError=(X=0.0,Y=0.0)
MaxZoomAimError=(X=0.0,Y=0.0)
	- Bullet drift per shoot while aiming;

	> SHOTGUNS:projectiles pattern and count are capped;
	- AimError will calculate accuracy for each pellet;

AccFirePenalty=0.0f
ZoomAccFirePenalty=0.0f
	- Determines cone of fire increase per shot from the hip/zoom;

AccFireInterpSpeed=0.0f
ZoomAccFireInterpSpeed=0.0f
	- Determines how quick accuracy parameters approximate their maximal values per shot from the hip/zoom;
	- Bigger values = greater speed;
	~ MaxAimError > AccFireInterpSpeed - AccFirePenalty > MinAimError;


	------------- AI weapons -------------
	// X=min; Y=max //;

AI_AccCone_Max=(X=0.0,Y=0.0)
	- Maximal accuracy cone for AI;
AI_AccCone_Min=(X=0.0,Y=0.0)
	- Minimal accuracy cone for AI;
AI_AimDelay=(X=0.0,Y=0.0)
	- Aiming time;
	min=0.0; max~=99.0;
	- Accuracy values recalculated separately for enemies and squadmates;
	i.e. increased/decreased cone of bullets spead on firing;


	======== Sight ========

> Don't affect on accuracy - just on player's HUD;
> Counts as dynamic values:  greater values = bigger scope;
	10 ~= 1 cm;

	// X=min; Y=max //;
CrosshairRange=(X=0.0,Y=0.0)
	- Scope/crosshair unscoped;
ZoomCrosshairRange=(X=0.0,Y=0.0)
	- Scope/crosshair size scoped (aiming);
	min=15; max=99;
	// recomended: min=25; max=60; in =99 disappear completely //;
	// synchronize Accuracy and CrosshairRange: 0.1=20 //;

bUseSniperCam=true
	- Sniper scope usage for a weapon;
	true=used; false=unused;
	// actulaly sniper scope only appeares on sniper rifles, for other weapons it only allows to aim from 1-st person view //;

ZoomFOV=0
	- Sniper scope Field Of View - magnification (bigger number=smaller zoom);
	min~=10; max~=100;


	======== Recoil =========

> Not weapon firing animation (knock back-s), just a gun barrel and crosshair sway from one side to another on firing;

Recoil=(X=0.0,Y=0.0)
	- Recoil hip fire;
ZoomRecoil=(X=0.0,Y=0.0)
	- Recoil aim fire;
RecoilCap=0.0f
	- Max recoil hip fire;
ZoomRecoilCap=0.0f
	- Max recoil aim fire;
RecoilInterpSpeed=0.0f
	- Shakiness of the screen when firing;
RecoilFadeSpeed=0.0f
	- Rate of recoil fade hip fire;
RecoilZoomFadeSpeed=0.0f
	- Rate of recoil fade aim fire;
RecoilYawScale=0.0f
	- Shakiness angle (up/down) when firing;
RecoilYawBias=0.0f
	- Shakiness angle (left/right) when firing;
RecoilYawFrequency=0.0f
	- Shakiness angle (top-right > middle-right) when firing;
RecoilPitchFrequncy=0.0f
	- Shakiness angle (top-left > middle-left) when firing;
RecoilPitchOscillation=0.0f
	- Shakiness angle (round random order) when firing;
RecoilMinFadePitch=0.0f
RecoilMinFadeYaw=0.0f
	- Rate of recoil fade;


	======== Reload speed ========

ReloadSuccessDuration=0.0
ReloadFailureDuration=0.0
	- Values are identical - set equals;
	min~=0.1; max=unlimited;  // in seconds //;

EjectShellCasingTimeRatio=0.0
	- Thermal clip removal animation time;
	min=0.0; max=unlimited;  // in seconds //;

	======== Tracer projectiles ========

TracerSpawnOffset=0.0
	- Frequency of tracers - visible projectiles and trails;
	min=0.0; max=MagSize;
	- if max value is used, every bullet in magazine will be tracer-type;

TraceRange=0
	- Max tracer travel distance;
	// must be equal or less than ImpactRelevanceDistance value //;

ShowTracerDistance=0
	- Max tracer visibility distance;
	// must be equal or less than ImpactRelevanceDistance value //;


	======== Fire range & ranged damage ========

Range_Melee=300.f
Range_Short=800.f
Range_Medium=1500.f
Range_Long=2000.f
	- Max relevant damage on hit distances;
	min=10.0f; max=ImpactRelevanceDistance;  // in meters, as distance multiplier //;
	- Multipliers for DamageMod_-s - what damage amount would be dealt depending of Range_;

DamageMod_MeleeRange=0.0f
DamageMod_ShortRange=0.0f
DamageMod_MediumRange=0.0f
DamageMod_LongRange=0.0f
DamageMod_VeryLongRange=0.0f
	- Damage multipliers for projectiles travel distances;
	min=0.01f; max=unlimited;  // in %-s, as (Damage=) multiplier //;  (1.0f=100%)
	- All values =1.0f - the weapon will deal same (static) amount of damage, no matter the distance;

ImpactRelevanceDistance=8000
	- Max target hit range;
	min=10; max=41000;  // in meters //;
	(max= m_fVehicleInCombatMaxRange=41000; as ~max combat range in the game);

> Ballistics: when projectile travels in a range of distance (Range_), it will deal damage (DamageMod_);


	======== Aiming assistance/Auto aiming ========

> See description in Global Aiming assistance/Auto aiming readme section;
> Most values counts as degrees:
	1 ~= 10°; (where 36~=360°);
	min~=0.01; max~=36;
> If you set greater values to min/max AimError, min/max AccFirePenalty and enable Auto aiming (add and increase values) -
you'll can convert your weapons into "Zorg ZF-1 Pod Weapon System" from "5th Element" movie ;)

	------------- Magnetic correction -------------
AimCorrectionAmount=0.0
MagneticCorrectionThresholdAngle=0
MaxMagneticCorrectionAngle=0
	- The maximum amount of correction - how close you must be to your target;  // in degrees //;
	- This values (used by sniper rifles by-default), converting all bullets to homing-sticky type;

	------------- Friction -------------
bFrictionEnabled=true
MinFrictionDistance=0.f
MaxFrictionDistance=5000.f
PeakFrictionDistance=2000.f
FrictionMultiplierRange=(X=0.28f,Y=0.28f)
bFrictionDistanceScalingEnabled=false
PeakFrictionRadiusScale=1.25f
PeakFrictionHeightScale=0.4f
FrictionTargetOffset=(Z=22.f)

	------------- Adhesion -------------
bAdhesionEnabled=true
MinAdhesionDistance=100.f
MaxAdhesionDistance=6000.f
MinAdhesionVelocity=80.f
CamInputAdhesionDamping=0.4f
bAdhesionDuringCam=true
MaxLateralAdhesionDist=125.f
AdhesionRot=(X=0.f,Y=1.f)



[++++++++++++++++++++ Additional properties ++++++++++++++++++++]

bUpgradesBasicWeapon=true
	- Probably replaces Avenger, Shuriken, ... with new picked up weapon for squad, when you recruit someone;


	======== Enemy hit/death reactions ========

	[SFXGameContent_Inventory.SFXDamageType_...] - for each gun;

Penetration=PenetrationType_Light
	- Determines weapon penetration type on enemy hit;
	available types: _VeryLight _Light _Medium _Heavy;

bCausesPhysicsImpact=true
	- Allow physical damage on target: yes/no;

bCausesRagdoll=false
	- Enemy corpse ragdoll can be spawn: yes/no;

fChanceofRagdoll=0.005
	- Result will be in %-s 0.7=70%, where 1.0=100%(max) / per shot;

fPhysicsReactionTimeScale=0.3
	- Target physical damage reaction time;

HitReactions=(BodyPart="Head" ... ;
	- Determines enemy's various reactions for damage on hit;



[++++++++++++++++++++ Notes ++++++++++++++++++++]
https://en.wikipedia.org/wiki/Physics_of_firearms