Hearing - Add Peltor-style Earpro to Headgear with a 2-Ear Headset

addons/hearing/CfgWeapons.hpp

@@ -46,7 +46,7 @@ class CfgWeapons {
 
     class HelmetBase;
     class H_Cap_headphones: HelmetBase {
-        HEARING_PROTECTION_EARMUFF;
+        HEARING_PROTECTION_PELTOR;
     };
 
     class H_Construction_earprot_base_F: HelmetBase {
@@ -112,4 +112,28 @@ class CfgWeapons {
     class H_HelmetHBK_headset_base_F: H_HelmetHBK_base_F {
         HEARING_PROTECTION_PELTOR;
     };
+
+    // Military headgear with a both-ear headset (similar to the modern INVISIO X7) should have active earpro.
+    class H_Watchcap_blk: HelmetBase {
+        HEARING_PROTECTION_PELTOR;
+    };
+    class H_Bandanna_khk;
+    class H_Bandanna_khk_hs: H_Bandanna_khk {
+        HEARING_PROTECTION_PELTOR;
+    };
+    class H_Booniehat_khk;
+    class H_Booniehat_khk_hs: H_Booniehat_khk {
+        HEARING_PROTECTION_PELTOR;
+    };
+    class H_Cap_oli;
+    class H_Cap_oli_hs: H_Cap_oli {
+        HEARING_PROTECTION_PELTOR;
+    };
+    class H_MilCap_ocamo: HelmetBase {
+        HEARING_PROTECTION_PELTOR;
+    };
+    class H_Shemag_olive;
+    class H_Shemag_olive_hs: H_Shemag_olive {
+        HEARING_PROTECTION_PELTOR;
+    };
 };

docs/wiki/feature/hearing.md

@@ -19,18 +19,30 @@ version:
 Introduces hearing damage caused by nearby explosions and large-caliber weapons.
 
 ### 1.2 Earplugs
-Adds earplugs to mitigate that effect. Soldiers with high caliber weapons or
-missile launchers will be equipped with those, but remember to put them in.
+Adds earplugs to mitigate that effect. Soldiers with high caliber weapons or missile launchers will be automatically equipped with those, but remember to put them in.
+Their drawback is that they reduce the general hearing volume.
 
-### 1.3 Helmets
-Some types of helmets can mitigate hearing damage also (ie. crewman helmet, pilot helmet etc.).
+### 1.3 Electronic hearing protection
+Some types of helmets/hats with PELTOR-like earmuffs or 2-ear headsets can mitigate hearing damage by dropping the volume only when loid noises occour, without attenuating general hearing volume.
+The `Electronic Hearing Protection` item provides the same effect, with usage similar to earplugs.
+
+### 1.4 Crew hearing protection
+Armored vehicle crew and pilot helmets provide the best hearing protection while also dropping general volume, which can be desirable in loud vehicles as most communication happens via intercom or radios.
 
 ## 2. Usage
 
-### 2.1 Equipping earplugs
+### 2.1 Equipping Earplugs
 - For this you need the `Earplugs` item.
 - Press the self interaction key <kbd>Ctrl</kbd> + <kbd>⊞&nbsp;Win</kbd> (ACE3 default key bind `Self Interaction Key`).
 - Select `Equipment`.
 - Select `Earplugs in`.
 - Same method to remove them but the option is `Earplugs out`.
 - Note: you're able to re-use earplugs.
+
+### 2.2 Equipping Electronic Hearing Protection
+- For this you need the `Electronic Hearing Protection` item.
+- Press the self interaction key <kbd>Ctrl</kbd> + <kbd>⊞&nbsp;Win</kbd> (ACE3 default key bind `Self Interaction Key`).
+- Select `Equipment`.
+- Select `Put on Electronic Hearing Protection`.
+- Same method to remove it but the option is `Take off Electronic Hearing Protection`.
+- Note: you're able to re-use Electronic Hearing Protection.