PiP

If your optic has magnification (e.g. 2x, 4x, 6x etc), you should define some additional attributes to enable the PiP. These attributes will have to be added in the config.cpp class definition of your optic.

The configurable attributes are:

• s_pipRadius: radius of the lens
  0.1 = very small | 0.9 = almost full screen
  
• s_pipMagnification: intensity of the magnification
  0.1 = low magnification | 0.5 = strong magnification
  

  The final lens magnification also depends on the user option of the lens magnification. See user options for more info

• s_pipBlur: blur of the PiP circumference
  0.01 = sharp | 0.3 = very blurred
  

  The s_pipBlur MUST be a non-zero value or the PiP won't work. If you don't want blur, use small values instead (e.g. 0.001)

• s_pipChromAber: chromatic aberration intensity
  0.01 = sharp | 0.3 = very blurred
  
• s_pipOffset: horizontal and vertical offset of the PiP on the screen.
  Acceptable values are between -1.0 and 1.0;
  You shouldn't need to change these.
  
• s_pipLensOffset: horizontal and vertical offset of magnification
  Acceptable values are between -1.0 and 1.0;
  You shouldn't need to change these.
  

Other parameters

If your optic has a "fullscreen reticle", like the vanilla HuntingOptic, you should enable the s_isFullscreen to make the optic behave correctly, and optionally the s_showEnterMisalignment to enable a slight misalignment effect upon entering the optic.

Both are boolean options: they accept true(1) or false(0)

	s_isFullscreen = 1;
	s_showEnterMisalignment = 1;
						

Attachments stats

Attachments play a major role in the final recoil computation as they could heavily modify the before mentioned values of the recoils (i.e. mouse, stability, misalignment, kick), hence improving (or also worsen) the recoil.

How attachments stats work

All the stats are defined in percentage (0.0 = 0%, 0.69 = 69%, 1.0 = 100%, -0.42 = -42%) and they're additive, which means that if two attachments are being used, and they reduce the "kick" respecitevly by 40% and 29%, the final kick reduction will be of 69% (40 + 29 = 69).
So be mindful when choosing the stats.

Define attachments stats

The definition is done through the config.cpp. The configurable attributes are:

• s_recoilControlMouseX: control of horizontal mouse offset
• s_recoilControlMouseY: control of vertical mouse offset

I highly suggest not to modify the recoil control of the mouse offset, for a mere design reason.

• s_recoilControlStabilityX: control of horizontal stability
• s_recoilControlStabilityY: control of vertical stability
• s_recoilControlMisalignmentX: control of horizontal misalignment
• s_recoilControlMisalignmentY: control of vertical misalignment
• s_recoilControlKick: control of the kick

This is an example of stats for Mp5 attachments:

class cfgVehicles {
	class Inventory_Base;
	class MP5k_StockBttstck : Inventory_Base {
		s_recoilControlStabilityX = 0.50;
		s_recoilControlStabilityY = 0.50;
		s_recoilControlMisalignmentX = 0.00;
		s_recoilControlMisalignmentY = 0.25;
		s_recoilControlKick = 0.75;
	};
	class MP5_RailHndgrd : Inventory_Base {
		s_recoilControlStabilityX = 0.20;
		s_recoilControlStabilityY = 0.20;
		s_recoilControlMisalignmentX = 0.50;
		s_recoilControlMisalignmentY = 0.50;
	};
	class MP5_Compensator : Inventory_Base {
		s_recoilControlMisalignmentX = 0.45;
		s_recoilControlMisalignmentY = 0.05;
	};
};							
					

Integrated attachments

Some weapons may not have removable attachments (e.g. M16A1 rifle)

In this case it's possible to add stats for "integrated attachment" directly in your weapon class

class cfgWeapons {
	class Rifle_Base;
	class M16A2_Base : Rifle_Base {
		s_recoilControlStabilityX = 0.65;
		s_recoilControlStabilityY = 0.65;
		s_recoilControlMisalignmentX = 0.75;
		s_recoilControlMisalignmentY = 0.80;
		s_recoilControlKick = 0.75;
	};			
};
						

So in this example, the M16A1 rifle will have those stats without attachments

class cfgVehicles {
	class Inventory_Base;
	class MyModdedButtstock : Inventory_Base {
		s_recoilControlStabilityX = 0.40;
		s_recoilControlStabilityY = 0.40;
		s_recoilControlMisalignmentX = 0.05;
		s_recoilControlMisalignmentY = 0.15;
		s_recoilControlKick = 0.60;
	};
	class MyModdedHandguard : Inventory_Base {
		s_recoilControlStabilityX = 0.20;
		s_recoilControlStabilityY = 0.20;
		s_recoilControlMisalignmentX = 0.55;
		s_recoilControlMisalignmentY = 0.45;
	};
	class MyModdedCompensator : Inventory_Base {
		s_recoilControlMisalignmentX = 0.10;
		s_recoilControlMisalignmentY = 0.05;
	};
};
class cfgWeapons {
	class Rifle_Base;
	class MyModdedWeapon : Rifle_Base {
		s_recoilControlStabilityX = 0.05;
		s_recoilControlStabilityY = 0.05;
		s_recoilControlMisalignmentX = 0.05;
		s_recoilControlMisalignmentY = 0.05;
		s_recoilControlKick = 0.05;
	};			
};